mcp-audit

MCP 監査

MCP サーバーのオーバーヘッドを分析し、整理を提案します。

トリガー

次の場合に使用します：

• セッションが遅い、またはコストが高いと感じる場合
• 新しい MCP サーバーを追加する場合
• コンテキストがすぐにいっぱいになる場合
• プロジェクト設定を見直す場合

主なポイント

各 MCP サーバーは、すべてのツールの説明をすべての API リクエストに追加します。20 個のツールを持つサーバーは、それらのツールを使うかどうかにかかわらず、リクエストごとに約 2K～4K トークンを追加します。

監査手順

ステップ 1：有効なサーバーを一覧表示する

すべての MCP 設定を確認します：

cat .claude/settings.json 2>/dev/null | grep -A 50 "mcpServers"
cat ~/.claude/settings.json 2>/dev/null | grep -A 50 "mcpServers"

ステップ 2：サーバーごとのツール数を数える

各サーバーのトークンオーバーヘッドを推定します：

• ツール 1～5 個：約 200～500 トークン（オーバーヘッド小）
• ツール 6～15 個：約 500～1500 トークン（オーバーヘッド中）
• ツール 16～30 個：約 1500～3000 トークン（オーバーヘッド大）
• ツール 30 個以上：約 3000 トークン以上（過剰 — ツールのフィルタリングを検討）

ステップ 3：使用状況を確認する

確認する項目：

• 今回のセッションで実際に使用されたサーバーはどれですか？
• 7 日以上使用されていないサーバーはどれですか？
• 機能が重複しているサーバーはありますか？
• 特定のタスクでのみ必要なサーバーはありますか？

ステップ 4：対応を提案する

無効化するサーバー：

• 7 日以上使用されていない
• 別の有効なサーバーと機能が重複している
• プロジェクト固有だが、現在は別のプロジェクトに取り組んでいる

維持するサーバー：

• 毎回のセッションで使用する（filesystem、git）
• 現在の作業に必要な、固有の機能を提供する
• ツール数が少ない（5 個未満）

出力

MCP AUDIT
  Active servers: [N]
  Total tools: [N]
  Estimated overhead: ~[N]K tokens per request

  Server Analysis:
    [name] — [N] tools, ~[N] tokens
      Status: KEEP / DISABLE / REVIEW
      Reason: [why]

  Recommendations:
    Disable: [list]
    Keep: [list]
    Review: [list]

  Projected savings: ~[N]K tokens per request (~$X.XX per session)

しきい値

• サーバー合計：10 未満（理想）、10～15（監視）、15 超（削減）
• ツール合計：80 未満（理想）、80～120（監視）、120 超（削減）
• サーバーごと：ツール 15 個未満（問題なし）、15～30 個（フィルタリング）、30 個超（分割または無効化）

ルール

• ユーザーの確認なしにサーバーを無効化しないでください
• 提案ごとにトークン削減量を推定してください
• タスクの状況を考慮してください。今日使われていないサーバーも、明日は重要になる可能性があります
• disabledMcpjsonServers を確認し、すでに無効化されているサーバーを再度提案しないでください