mcp-management

MCP 管理

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

概要

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

主なメリット：

• MCP 機能の段階的な開示（必要なものだけを読み込みます）
• タスクの要件に基づいた、ツール／プロンプト／リソースのインテリジェントな選択
• 1 つの設定ファイルによる複数サーバーの管理
• コンテキストを効率的に利用：サブエージェントが 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

2. 機能の検出

# Preferred: Using bun (faster)
bunx tsx scripts/cli.ts list-tools  # Saves to assets/tools.json
bunx tsx scripts/cli.ts list-prompts
bunx tsx scripts/cli.ts list-resources

# Alternative: Using bunx
bunx tsx scripts/cli.ts list-tools
bunx tsx scripts/cli.ts list-prompts
bunx 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"

次善策：直接スクリプトを実行

# Preferred: Using bun
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

# Alternative: Using bunx
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

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

実装パターン

パターン 1：Gemini CLI による自動実行（優先）

Gemini CLI を使用して、ツールの検出と実行を自動化します。

簡単な例：

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：複数サーバーのオーケストレーション

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

クイックスタート

方法 1：Gemini CLI（推奨）

bun install -g gemini-cli  # or: bun add -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
bun install  # or: bun install
bunx tsx cli.ts list-tools  # Saves to assets/tools.json
bunx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

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

サブエージェントに MCP 操作を任せ、メインのコンテキストをクリーンに保ちます。

安全なインストール

MCP サーバーパッケージをインストールする際は、サプライチェーンセキュリティのベストプラクティスに従ってください。

• インストール後のスクリプトをブロック — npm config set ignore-scripts true（または Bun：デフォルトで無効）
• クールダウン期間を設ける — 新しいパッケージバージョンがコミュニティによって審査されるまで、7 日間待ちます
• インストール前に監査 — socket package score npm <pkg> を実行するか、socket npm install <pkg> を使用してパッケージを確認します

Socket CLI との統合、クールダウンの設定、ロックファイルの検証、CI による適用を含むセキュリティ設定の全容については、dependency-upgrade スキルを読み込んでください。

統合戦略

実行の優先順位

1. Gemini CLI（優先）：高速で、自動的に適切なツールを選択します

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

2. 直接 CLI スクリプト（次点）：ツールを手動で指定します

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

3. mcp-manager サブエージェント（フォールバック）：コンテキスト効率の高い委任

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

エージェントとの連携

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

• まず Gemini CLI が利用可能か確認する
• 利用可能な場合は gemini コマンドで実行する
• 失敗した場合は、直接スクリプトの実行に切り替える
• MCP の機能をメインコンテキストに読み込まずに確認する
• 結果をメインエージェントに報告する

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