mcp-management

MCP 管理

Model Context Protocol（MCP）サーバーを管理し、操作するためのスキルです。

概要

MCP は、AI エージェントが外部のツールやデータソースに接続できるオープンなプロトコルです。このスキルでは、メインのコンテキストウィンドウを汚染することなく、設定済みのサーバーから MCP の機能を検出、分析、実行するスクリプトとユーティリティを提供します。

主なメリット：

• MCP 機能の段階的な開示（必要なものだけを読み込みます）
• タスクの要件に基づいた、ツール／プロンプト／リソースのインテリジェントな選択
• 単一の設定ファイルによる複数サーバーの管理
• コンテキスト効率が高い：サブエージェントが MCP の検出と実行を担当します
• ツールカタログを保持：検出したツールを JSON に自動保存し、すばやく参照できます

このスキルを使用する場面

次の場合にこのスキルを使用します：

1. MCP 機能の検出：設定済みのサーバーで利用可能なツール／プロンプト／リソースの一覧が必要な場合
2. タスクに基づくツールの選択：特定のタスクに関連する MCP ツールを分析する場合
3. MCP ツールの実行：適切にパラメーターを処理しながら、MCP ツールをプログラムで呼び出す場合
4. MCP の統合：MCP クライアントの実装を構築またはデバッグする場合
5. コンテキスト管理：MCP 操作をサブエージェントに委任して、コンテキストの汚染を避ける場合

主な機能

1. 設定管理

MCP サーバーは .claude/.mcp.json で設定します。

Gemini CLI との統合（推奨）：.gemini/settings.json へのシンボリックリンクを作成します：

mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json

references/configuration.md と references/gemini-cli-integration.md を参照してください。

2. 機能の検出

npx tsx scripts/cli.ts list-tools  # Saves to assets/tools.json
npx tsx scripts/cli.ts list-prompts
npx tsx scripts/cli.ts list-resources

複数のサーバーの機能を集約し、サーバーを識別できるようにします。

3. インテリジェントなツール分析

LLM は assets/tools.json を直接分析します。キーワードマッチングアルゴリズムよりも優れています。

4. ツールの実行

主な方法：Gemini CLI（利用可能な場合）

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

次の方法：直接スクリプト

npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

フォールバック：mcp-manager サブエージェント

完全な例については、references/gemini-cli-integration.md を参照してください。

実装パターン

パターン 1：Gemini CLI による自動実行（主な方法）

Gemini CLI を使用して、ツールの検出と実行を自動化します。完全なガイドについては、references/gemini-cli-integration.md を参照してください。

簡単な例：

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

メリット：ツールの自動検出、自然言語による実行、サブエージェントによるオーケストレーションより高速です。

パターン 2：サブエージェントによる実行（フォールバック）

Gemini CLI を利用できない場合は、mcp-manager エージェントを使用します。サブエージェントがツールを検出し、関連するツールを選択してタスクを実行し、結果を報告します。

メリット：メインコンテキストをすっきり保ち、必要なときに関連するツール定義だけを読み込みます。

パターン 3：LLM 主導のツール選択

LLM が assets/tools.json を読み取り、コンテキストの理解、同義語、意図の認識を活用して、関連するツールをインテリジェントに選択します。

パターン 4：複数サーバーのオーケストレーション

複数のサーバー間でツールを連携させます。各ツールは適切にルーティングできるよう、接続元のサーバーを識別します。

スクリプトのリファレンス

scripts/mcp-client.ts

MCP クライアントマネージャーのコアクラスです。以下を処理します：

• .claude/.mcp.json からの設定の読み込み
• 複数の MCP サーバーへの接続
• すべてのサーバーにまたがるツール／プロンプト／リソースの一覧表示
• 適切なエラー処理を伴うツールの実行
• 接続ライフサイクルの管理

scripts/cli.ts

MCP 操作用のコマンドラインインターフェースです。コマンド：

• list-tools - すべてのツールを表示し、assets/tools.json に保存します
• list-prompts - すべてのプロンプトを表示します
• list-resources - すべてのリソースを表示します
• call-tool <server> <tool> <json> - ツールを実行します

注：list-tools は、完全なスキーマを含むツールカタログ全体を assets/tools.json に保存します。これにより、すばやい参照、オフラインでの閲覧、バージョン管理が可能になります。

クイックスタート

方法 1：Gemini CLI（推奨）

npm install -g gemini-cli
mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json
gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

方法 2：スクリプト

cd .claude/skills/mcp-management/scripts && npm install
npx tsx cli.ts list-tools  # Saves to assets/tools.json
npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

方法 3：mcp-manager サブエージェント

詳しいガイドは、references/gemini-cli-integration.mdを参照してください。

技術詳細

以下については、references/mcp-protocol.mdを参照してください。

• JSON-RPC プロトコルの詳細
• メッセージの種類と形式
• エラーコードと処理方法
• トランスポートの仕組み（stdio、HTTP+SSE）
• ベストプラクティス

統合戦略

実行の優先順位

1. Gemini CLI（第一候補）：高速、自動、インテリジェントなツール選択

   • 確認：command -v gemini
   • 実行：gemini -y -m gemini-2.5-flash -p "<task>"
   • 最適な用途：利用可能な場合のすべてのタスク

2. 直接 CLI スクリプト（第二候補）：ツールを手動で指定

   • 使用する場面：特定のツール／サーバーを制御する必要がある場合
   • 実行：npx tsx scripts/cli.ts call-tool <server> <tool> <args>

3. mcp-manager サブエージェント（代替手段）：コンテキストを効率よく委任

   • 使用する場面：Gemini が利用できない、または失敗した場合
   • メインコンテキストをクリーンに保ちます

エージェントとの統合

mcp-manager エージェントは、このスキルを使用して以下を行います。

• まず Gemini CLI が利用可能か確認
• 利用可能な場合は、gemini コマンドで実行
• 直接スクリプトの実行にフォールバック
• メインコンテキストに読み込まずに MCP の機能を検出
• 結果をメインエージェントに報告

これにより、メインエージェントのコンテキストをクリーンに保ち、効率的な MCP 統合を実現します。