Claude Code プロジェクト設定管理 - MCP サーバー管理、Claude 設定管理、Claude リソース一覧表示、Claude Code CLI 更新を提供

version
2.1.0
GitHub stars
7

Install

/plugin install shiiman-claude@shiiman-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 4

Claude MCP Manage

MCP サーバーの一覧表示・追加・削除を統合して管理します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-claude:mcp - MCP サーバー管理

概要:
  MCP サーバーの一覧表示・追加・削除を一つのスキルで管理する。
  引数があれば優先し、なければ発話内容から操作を判定。

使用方法:
  /shiiman-claude:mcp [操作] [オプション]

操作:
  list     MCP サーバー一覧を表示
  install  MCP サーバーを追加
  remove   MCP サーバーを削除

オプション:
  --help   このヘルプを表示

例:
  /shiiman-claude:mcp              # 発話内容から操作を判定
  /shiiman-claude:mcp list         # MCP サーバー一覧を表示
  /shiiman-claude:mcp install      # MCP サーバーを追加
  /shiiman-claude:mcp remove       # MCP サーバーを削除

実行手順

1. 操作種別の決定

  • 引数が指定されていれば引数を優先
  • 引数がない場合は発話内容から以下を判定:
    • 一覧系: list
    • 追加系: install
    • 削除系: remove

2. 操作の実行

list
  1. claude mcp list を実行
  2. 結果を整形して表示
install
  1. ユーザーに以下を確認:
    • サーバー名(例: github, filesystem, puppeteer)
    • スコープ(user または project)
  2. 実行内容を確認してから claude mcp add <name> --scope <scope> を実行
  3. 必要な環境変数がある場合は案内
remove
  1. claude mcp list で現在の一覧を表示
  2. ユーザーに削除対象のサーバー名を確認
  3. 実行内容を確認してから claude mcp remove <name> を実行

人気の MCP サーバー

名前説明必要な環境変数
githubGitHub API 操作GITHUB_PERSONAL_ACCESS_TOKEN
filesystemファイルシステム操作なし
puppeteerブラウザ自動化なし
postgresPostgreSQL 操作DATABASE_URL
sqliteSQLite 操作なし

出力フォーマット

## MCP サーバー管理

### 実行モード

- list / install / remove

### 結果

- 実行コマンド: claude mcp ...
- ステータス: 成功 / 失敗
- 補足: 必要なら環境変数の案内

重要な注意事項

  • ✅ install/remove は実行前に必ず確認する
  • ✅ list ではサーバーが0件のケースを考慮する
  • ✅ 必要な環境変数を案内する
  • ❌ 環境変数の値そのものは設定しない

Claude Resource List

プロジェクトの Claude Code リソース一覧を表示します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-claude:resource-list - Claude リソース一覧

概要:
  プロジェクトの Claude Code リソース(スキル・エージェント・フック)を一覧表示する。

使用方法:
  /shiiman-claude:resource-list

オプション:
  --help  このヘルプを表示

表示対象の伝え方(フラグの代わり):
  「スキル」「スキル一覧」      → スキルのみ表示
  「エージェント」「agent」     → エージェントのみ表示
  「フック」「hook」            → フックのみ表示
  指定なし                     → すべて表示

例:
  /shiiman-claude:resource-list   # すべてのリソースを表示
  「スキル一覧を見せて」           # スキルのみ表示
  「エージェント一覧」             # エージェントのみ表示

実行手順

1. 表示対象を決定(フラグの代わり)

発話内容から skills / agents / hooks / all を判定する。明示がなければ all(すべて表示)とする。読み取り専用のため確認は不要。

2. リソースを収集

  • スキル: .claude/skills/ 配下の SKILL.md を持つディレクトリ
  • エージェント: .claude/agents/ 配下の .md ファイル
  • フック: .claude/settings.json と .claude/settings.local.json の hooks セクション

3. 一覧を整形して表示

  • スキル: 名前と説明
  • エージェント: 名前と説明
  • フック: イベント別の件数サマリ

出力フォーマット

## Claude リソース一覧

### スキル (N)

| スキル | 説明 |
| ------ | ---- |

### エージェント (N)

| エージェント | 説明 |
| ------------ | ---- |

### フック (N)

| イベント | 件数 |
| -------- | ---- |

重要な注意事項

  • ✅ 存在しないディレクトリやファイルはスキップ
  • ✅ リソースが0件のときは「なし」と明示
  • ✅ hooks はサマリ表示とする
  • ❌ 詳細編集は行わない(一覧のみ)

Claude Settings Manage

Claude Code の設定ファイル表示と更新を一つのスキルで管理します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-claude:settings - Claude 設定管理

概要:
  Claude Code 設定の表示・更新・ローカル更新を統合管理する。
  引数があれば優先し、なければ発話内容から操作を判定。

使用方法:
  /shiiman-claude:settings [操作] [オプション]

操作:
  view          設定を表示
  update        .claude/settings.json を更新
  local-update  .claude/settings.local.json を更新

オプション:
  --help        このヘルプを表示

例:
  /shiiman-claude:settings              # 発話内容から操作を判定
  /shiiman-claude:settings view         # 設定を表示
  /shiiman-claude:settings update       # settings.json を更新
  /shiiman-claude:settings local-update # settings.local.json を更新

実行手順

1. 操作種別の決定

  • 引数が指定されていれば引数を優先
  • 引数がない場合は発話内容から以下を判定:
    • 表示系: view
    • 更新系: update
    • ローカル更新系: local-update

2. 操作の実行

view
  1. .claude/settings.json を読み込む
  2. .claude/settings.local.json が存在する場合は読み込む
  3. 設定内容をセクション別に整形表示
update
  1. .claude/settings.json の存在確認(なければ作成フローへ)
  2. 変更内容を確認(permissions / allowedTools / env / hooks / その他)
  3. 既存設定を保持したマージ更新を実施
  4. 更新結果を報告
local-update
  1. .claude/settings.local.json の存在確認(なければ作成フローへ)
  2. 変更内容を確認(個人用 permissions / allowedTools / env / その他)
  3. 既存設定を保持したマージ更新を実施
  4. 更新結果を報告

ファイル未存在時の作成

  • .claude ディレクトリがない場合は mkdir -p .claude
  • それぞれテンプレートから新規作成可能

settings.json 基本テンプレート

{
  "permissions": {
    "allow": [],
    "deny": []
  },
  "allowedTools": []
}

settings.local.json 基本テンプレート

{
  "permissions": {
    "allow": [],
    "deny": []
  }
}

出力フォーマット

## Claude Settings 管理

### 実行モード

- view / update / local-update

### 結果

- 対象ファイル: .claude/settings.json or .claude/settings.local.json
- 変更点: 箇条書きで要約
- ステータス: 成功 / 失敗

重要な注意事項

  • ✅ settings.json / settings.local.json の役割を区別する
  • ✅ 既存設定を保持したマージ更新を行う
  • ✅ 機密情報は表示時にマスクする
  • ✅ ファイルがなければテンプレートで作成できる
  • ❌ 設定ファイル全体を無条件上書きしない

Claude Update

Claude Code CLI のバージョン確認と更新を行います。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-claude:update - Claude Code 更新

概要:
  Claude Code CLI のバージョン確認・更新、プラグイン一括更新を実行する。
  Homebrew 管理の場合は brew upgrade を使用。

使用方法:
  /shiiman-claude:update [操作] [オプション]

操作:
  version        現在のバージョンを確認
  update         Claude Code CLI を更新
  plugin-update  インストール済みプラグインを一括更新

オプション:
  --help         このヘルプを表示

例:
  /shiiman-claude:update                # 発話内容から操作を判定
  /shiiman-claude:update version        # バージョン確認
  /shiiman-claude:update update         # Claude Code を更新
  /shiiman-claude:update plugin-update  # プラグインを一括更新

実行手順

1. 操作種別の決定

  • 引数が指定されていれば引数を優先
  • 引数がない場合は発話内容から以下を判定:
    • 確認系: version
    • 更新系: update
    • プラグイン更新系: plugin-update

2. 操作の実行

version
  1. claude --version で現在のバージョンを表示
  2. claude update に check 専用オプションがないことを明示
  3. 更新したい場合は update モード実行を案内
update
  1. claude --version で更新前バージョンを取得
  2. 実行前にユーザー確認を行う
  3. インストール方法を判定:
    • macOS かつ brew list --versions claude-code が成功する場合: brew upgrade claude-code
    • それ以外: claude update
  4. claude --version で更新後バージョンを確認
  5. 結果と必要な次アクション(再起動など)を報告
plugin-update
  1. marketplace キャッシュを最新化:
# known_marketplaces.json から marketplace 一覧と installLocation を取得
cat ~/.claude/plugins/known_marketplaces.json

各 marketplace の installLocation で git pull を実行:

git -C <installLocation> pull 2>&1
  1. ~/.claude/settings.json の enabledPlugins から有効プラグイン一覧を取得:
cat ~/.claude/settings.json

enabledPlugins のキーは <plugin>@<marketplace> 形式。値が true のもののみ対象。

  1. 各プラグインの更新前バージョンを記録:

~/.claude/plugins/cache/<marketplace>/<plugin>/ 配下のバージョンディレクトリ名から現在のバージョンを特定(最も新しいもの)。

  1. 実行前にユーザー確認を行う
  2. 各プラグインに対して claude plugin install <plugin>@<marketplace> を実行
  3. 更新後のバージョンを確認し、更新前後のバージョンを比較して結果を報告
  4. 更新があった場合「Claude CLI を再起動すると反映されます」と案内

出力フォーマット

## Claude Code 更新

### 実行モード

- version / update / plugin-update

### 結果

- 更新前: x.y.z
- 更新後: x.y.z(version 時は省略可)
- ステータス: 成功 / 失敗
- 補足: 必要に応じて再起動案内

### plugin-update 時の結果

| プラグイン | 更新前 | 更新後 | ステータス |
| ---------- | ------ | ------ | ---------- |

重要な注意事項

  • ✅ update 実行前に必ず確認する
  • ✅ Homebrew 管理の Claude Code は brew upgrade claude-code を使う
  • ✅ 更新前後のバージョン差分を明示する
  • ✅ plugin-update では各プラグインの更新前後バージョンを比較する
  • ✅ 失敗時はエラーメッセージをそのまま報告する
  • ❌ 失敗を推測で補完しない

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-claude
Category
Utility

More from shiiman/claude-code-plugins

All 9