mcp-usage-report

mcp-usage-report — MCP server / tool 利用率レポート

skill-analyzer plugin の MCP 利用率分析 skill。transcript JSONL から mcp__<server>__<tool> 形式の tool_use を抽出、 server 別 + tool 別に集計する。

skill-usage-report との違い

• MCP tool 起動は 全て transcript に記録される (auto-trigger 影響なし) → 数字は正確
• ただし tool 単位の enable/disable は Claude Code 公式仕様で非サポート → tool 別集計は server 内の優先度参考のみ、削除提案の対象外

実行手順

1. 対象期間決定 (skill-usage-report と同方針)

2. 集計実行:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/jsonl-usage.sh" \
     --since 2026-05-01 --until 2026-05-08
   

   出力には mcp_servers field が含まれる。ここを抽出して整形。

3. ユーザー表示:

   • server 別総起動回数 (降順)
   • server 内 tool 別起動回数 (各 server の tools field)
   • 0 起動 server = 削除候補 (settings.json の mcpServers から外す or enabledMcpjsonServers allowlist 化を提案)

4. 削除提案時の手順案内:

   // ~/.claude/settings.json or .claude/settings.json
   {
     "enabledMcpjsonServers": ["playwright", "ccusage"]
     // 0 起動の server は allowlist から外す = 自動 disable
   }
   

出力例

## MCP usage report (2026-05-01 → 2026-05-08)

### 起動された server

| server | total invocations | top tools |
|---|---:|---|
| playwright | 182 | browser_take_screenshot (73), browser_navigate (46) |

### 0 起動 server (削除候補)

| server | settings.json での無効化方法 |
|---|---|
| (該当なし) | - |

注意

• server を enabledMcpjsonServers allowlist に入れる方式は、ユーザーが他 project / session で使用している可能性も考慮 (project local vs user global) 。 user global 設定変更時は dry-run 推奨。
• tool 単位制御は不可なので、ユーザーから「特定 tool だけ無効化したい」と聞かれた場合は 公式仕様で非サポート、server 単位のみ を案内する。

関連 skill

• improvement-proposal: server 削除候補を含む統合提案
• skill-usage-report: skill 利用率の同種分析