mcp-manager

MCP Manager スキル

概要

Model Context Protocol サーバーの設定を管理する MCP Manager CLI ツールの自然言語インターフェースです。ユーザーは「filesystem MCP を有効にして」「データベースサーバーを追加して」「自分の MCP をすべて表示して」のように、会話形式で操作できます。

起動条件

3 メッセージ以内に MCP に関するキーワードが含まれている場合、または /mcp-manager を明示的に呼び出した場合に起動します。

コマンド

1. MCP を一覧表示

設定済みのすべての MCP サーバーとステータスを表示します。

• 「自分の MCP をすべて一覧表示して」／「自分の MCP サーバーを表示して」
• CLI：python3 -m mcp-manager.cli list

2. MCP を有効化

無効になっている MCP サーバーを有効にします。

• 「filesystem MCP を有効にして」／「puppeteer をオンにして」
• CLI：python3 -m mcp-manager.cli enable <server-name>

3. MCP を無効化

MCP サーバーを削除せずに無効にします。確認が必要です。

• 「puppeteer MCP を無効にして」／「github をオフにして」
• CLI：python3 -m mcp-manager.cli disable <server-name>

4. MCP を追加

対話形式で新しい MCP サーバーを追加します（名前、コマンド、引数、環境変数を収集します）。

• 「新しい MCP サーバーを追加して」／「データベース MCP を設定して」
• CLI：python3 -m mcp-manager.cli add <name> <command> [args...] --env KEY=VALUE

5. MCP を削除

MCP サーバーの設定を完全に削除します。警告を伴う確認が必要です。

• 「puppeteer MCP を削除して」／「old-server を削除して」
• CLI：python3 -m mcp-manager.cli remove <server-name>

6. MCP を表示

指定した MCP サーバーの詳細情報を表示します。

• 「filesystem MCP を表示して」／「github サーバーの詳細を表示して」
• CLI：python3 -m mcp-manager.cli show <server-name>

7. MCP を検証

すべての MCP 設定にエラーがないか確認します。

• 「自分の MCP 設定を検証して」／「MCP のエラーを確認して」
• CLI：python3 -m mcp-manager.cli validate

8. MCP をエクスポート

バックアップ用に設定を JSON ファイルへエクスポートします。

• 「自分の MCP 設定をエクスポートして」／「自分の MCP をバックアップして」
• CLI：python3 -m mcp-manager.cli export [output-file]

9. MCP をインポート

JSON ファイルから設定をインポートします。

• 「backup.json から MCP をインポートして」／「自分の MCP を復元して」
• CLI：python3 -m mcp-manager.cli import <input-file> [--merge]

使用例

例 1：一覧表示と有効化

ユーザー：「自分の MCP をすべて一覧表示して」

[実行：cd .claude/scenarios && python3 -m mcp-manager.cli list]

応答： 「MCP サーバーが 3 つ設定されています。 ✓ filesystem（有効）- ローカルファイルシステムへのアクセス ✓ github（有効）- GitHub API との統合 ✗ puppeteer（無効）- ブラウザーの自動操作」

続けて：「puppeteer をオンにして」

[実行：python3 -m mcp-manager.cli enable puppeteer]

「✓ 'puppeteer' MCP サーバーを正常に有効にしました。」

例 2：新しいサーバーの追加

ユーザー：「データベースにアクセスするための新しい MCP を追加して」

対話形式での情報収集：

1. 名前：「postgres-local」
2. コマンド：「node /opt/mcp-servers/postgres/index.js」
3. 引数：「--port 5432 --host localhost」
4. 環境変数：「DATABASE_URL=postgresql://localhost:5432/mydb」

[実行：python3 -m mcp-manager.cli add postgres-local "node /opt/mcp-servers/postgres/index.js" --port 5432 --host localhost --env "DATABASE_URL=postgresql://localhost:5432/mydb"]

「✓ 'postgres-local' MCP サーバーを正常に追加しました。 サーバーは現在無効です。'enable postgres-local' で有効にしてください。」

例 3：サーバーの削除

ユーザー：「puppeteer MCP を削除して」

確認： 「⚠️ 警告：'puppeteer' MCP サーバーを削除しようとしています。設定は完全に削除されます。この操作は元に戻せません。本当によろしいですか？（yes/no）」

[ユーザーが確認：「yes」]

[実行：python3 -m mcp-manager.cli remove puppeteer]

「✓ 'puppeteer' MCP サーバーを正常に削除しました。」

ツールの呼び出し

すべてのコマンドは ~/.amplihack/.claude/scenarios/ ディレクトリから実行します。

cd .claude/scenarios && python3 -m mcp-manager.cli <command> [args]

主なコマンド：

• list - すべての MCP を一覧表示
• enable <name> - サーバーを有効化
• disable <name> - サーバーを無効化
• add <name> <cmd> [args...] --env KEY=VAL - サーバーを追加
• remove <name> - サーバーを削除
• show <name> - 詳細を表示
• validate - すべての設定を検証
• export [file] - JSON にエクスポート
• import <file> [--merge] - JSON からインポート

出力の処理：

• 成功：終了コード 0、標準出力に ✓ プレフィックス付きのメッセージ
• エラー：0 以外の終了コード、標準エラー出力に ❌ プレフィックス付きのメッセージ
• 応答内の機密情報（トークン、パスワードなど）を伏せ字にする

エラー処理

よくあるエラー：

1. CLI が見つからない：インストール手順を案内します（README を参照）
2. サーバーが見つからない：利用可能なサーバーを一覧表示し、代替候補を提案します
3. サーバーがすでに存在する：表示、削除、または名前の変更を提案します
4. アクセスが拒否された：ファイルまたはディレクトリのアクセス権を確認します
5. settings.json の形式が正しくない：JSON を検証し、バックアップからの復元を提案します
6. コマンドが無効：一般的なコマンドのパターンを表示します

エラーの詳細なケースとトラブルシューティングについては、~/.amplihack/.claude/scenarios/mcp-manager/README.md を参照してください。

ベストプラクティス

• 破壊的な操作（無効化、削除）を行う前に、必ず確認します
• 実行前にサーバー名を検証します
• 応答内の機密情報を伏せ字にします
• 次に実行できる手順を示した、明確なエラーメッセージを表示します
• 変更の前後に現在の状態を表示します

関連項目

• ドキュメント全文：~/.amplihack/.claude/scenarios/mcp-manager/README.md
• ツール作成ガイド：~/.amplihack/.claude/scenarios/mcp-manager/HOW_TO_CREATE_YOUR_OWN.md
• MCP プロトコル：https://modelcontextprotocol.io/
• Claude Code の設定：~/.amplihack/.claude/settings.json

---

バージョン： 1.0.0 | 更新日： 2025-11-24 | メンテナー： amplihack チーム