mcp-checkup

mcp-checkup

MCP サーバーがコンテキストウィンドウをどれだけ消費しているか、調べてみましょう。

mcp-checkup は、MCP の構成を分析する MCP サーバーです。インストール済みの各サーバーとツールのトークンコストを測定し、重複を見つけ、効率を評価して、最適化レポートを作成します。

クイックスタート

npx mcp-checkup

次に、AI アシスタントに次のように尋ねてください。

"Run an MCP health check on my setup"
"How many tokens are my MCP servers using?"
"Generate an MCP health report"

なぜ必要？

MCP ツールは、スキーマだけで 550～1,400 トークンを消費します。50 個のツールを持つサーバーは、何も入力していない段階で 30,000 トークン以上を消費することがあります。MCP サーバーがコンテキストウィンドウをどれだけ消費しているのか、把握していない開発者は少なくありません。

コミュニティからの実例：

• GitHub MCP を追加したところ、あるユーザーのトークン使用量が 34K から 80K に増加しました（出典）
• ある開発者は、会話を始める前に、わずか 4 つのサーバーだけで 67,000 トークンが消費されていることを発見しました（出典）
• 週間ダウンロード数が 240K の Context7 は、必要以上に 3 倍ものトークンをツールの説明に消費しています（出典）

ツール

analyze_servers

MCP の設定をスキャンし、インストール済みの各サーバーのトークンコストを測定します。設定ファイルを自動検出します。

"Which of my MCP servers costs the most tokens?"

analyze_tools

特定のサーバーを詳しく分析します。ツールごとのトークンコスト、評価、冗長な説明、最適化の提案を確認できます。

"Break down the token cost of my GitHub MCP server"

find_duplicates

インストール済みのサーバー間で、ツール名の重複を見つけます。重複するツールはメリットがないままコンテキストを消費します。

"Do any of my MCP servers have overlapping tools?"

count_tokens

任意のテキストのトークン数を数えます。コンテキストの使用量の見積もりに便利です。

"How many tokens is this prompt?"

generate_report

サーバーの評価（A～F）、トークンコスト、重複、実行可能な改善案を含む、完全な Markdown 形式のヘルスレポートを作成します。

"Generate a full MCP health report"

評価システム

ツールごとの評価

評価	トークン数	意味
A	≤100	優秀 — コンテキストコストは最小限です
B	≤300	良好 — スキーマサイズは妥当です
C	≤600	普通 — 最適化できる可能性があります
D	≤1000	不十分 — スキーマが肥大化しています
F	>1000	不合格 — コンテキストウィンドウに深刻な影響を与えます

サーバーごとの評価

評価	合計トークン数	意味
A	≤500	無駄がなく効率的です
B	≤1500	妥当です
C	≤3000	重くなり始めています
D	≤6000	コンテキストコストが大きいです
F	>6000	コンテキストウィンドウを大幅に圧迫します

インストール

Claude Desktop / Claude Code

{
  "mcpServers": {
    "mcp-checkup": {
      "command": "npx",
      "args": ["-y", "mcp-checkup"]
    }
  }
}

Cursor

同じ形式で .cursor/mcp.json に追加します。

自動検出

mcp-checkup は、次の場所にある MCP の設定を自動的に検出します。

• .mcp.json（現在のディレクトリ）
• Claude Desktop の設定（Windows/macOS/Linux）
• .cursor/mcp.json

または、任意のツールにカスタムパスを渡すこともできます。

比較

ツール	目的	アプローチ
mcp-checkup	トークンコストを診断	分析してレポートを作成し、各ツールのコストを正確に確認
lean-ctx	トークン使用量を削減	実行時にコンテキストを圧縮
MCP Inspector	MCP サーバーをデバッグ	接続とツール呼び出しをテスト

まず mcp-checkup を使って問題を見つけてから、解決方法を決めてください。

MCP Toolkit の一部

すべてのサーバーを見る →

• webcheck-mcp — ウェブサイトの健全性分析
• git-summary-mcp — Git リポジトリの分析
• mcp-checkup — MCP セットアップの健全性分析
• dev-utils-mcp — 開発者向けユーティリティ
• codescan-mcp — コードベースの健全性スキャナー
• deadlink-checker-mcp — リンク切れ検出ツール

ライセンス

MIT