mcpspan

mcpspan-mcp

MCP サーバーについて、AI エージェントに質問できます。Claude Code、Cursor など、あらゆる MCP クライアントが mcpspan のデータをもとに回答します。

• 今週、最も失敗が多かったツールと、その理由は？
• 1.4.1 と 1.4.0 を比較するとどうですか？
• サーバーにない機能のうち、エージェントが求めているものは何ですか？
• Cursor は Claude より頻繁に失敗しますか？
• エージェントに表示されているのに、呼び出されていないツールはどれですか？

ダッシュボードで確認できる情報を参照するトークンを使ってデータを読み取り、何も変更しません。データの送信先は mcpspan 以外にありません。

デモで試す

アカウントは不要です。ライブデモでは、どのトークンからの質問にも回答します。Claude Code では、次のようにします。

claude mcp add mcpspan-demo \
  -e MCPSPAN_READ_TOKEN=demo \
  -e MCPSPAN_URL=https://demo-api.mcpspan.com \
  -- npx -y mcpspan-mcp

次に、デモサーバーの Flights について質問します。たとえば、この1日で何が起きましたか？

トークンを取得する

mcpspan で Settings → Read tokens を開き、トークンを作成します。一度だけ表示され、以下の行にあらかじめ入力されているので、そのままコピーできます。

エージェントに追加する

mcpspan Cloud

Claude Code：

claude mcp add mcpspan -e MCPSPAN_READ_TOKEN=mcpspan_read_... -- npx -y mcpspan-mcp

Cursor、Claude Desktop、Windsurf などでは、MCP の設定で次のようにします。

{
  "mcpServers": {
    "mcpspan": {
      "command": "npx",
      "args": ["-y", "mcpspan-mcp"],
      "env": { "MCPSPAN_READ_TOKEN": "mcpspan_read_..." }
    }
  }
}

セルフホスト

同様に、MCP サーバーが報告するアドレスを指定します。

claude mcp add mcpspan \
  -e MCPSPAN_READ_TOKEN=mcpspan_read_... \
  -e MCPSPAN_URL=http://localhost:6271 \
  -- npx -y mcpspan-mcp

{
  "mcpServers": {
    "mcpspan": {
      "command": "npx",
      "args": ["-y", "mcpspan-mcp"],
      "env": {
        "MCPSPAN_READ_TOKEN": "mcpspan_read_...",
        "MCPSPAN_URL": "http://localhost:6271"
      }
    }
  }
}

mcpspan 0.9.0 以降が必要です。エージェントがインターネット経由でインストール環境にアクセスする場合は、手前に HTTPS を設置してください。トークンはすべての質問とともに送信されます。

設定

変数
MCPSPAN_READ_TOKEN	読み取りトークンです。必須です。
MCPSPAN_URL	セルフホスト版 mcpspan のインストール環境の API です。省略した場合は https://api.mcpspan.com になります。

Node 20 以降が必要です。

ツール

すべてのツールは読み取り専用です。各ツールでは、サーバー名または ID を指定します（アカウントにサーバーが1つしかない場合は省略できます）。また、期間も指定します。現在からさかのぼる days（省略時は7日間）、または from と to を指定できます。

ツール	回答する内容
list_servers	アカウントが報告しているサーバー。
get_overview	呼び出し数、失敗数、エラー率、応答時間、クライアント。
list_tools	呼び出し数、エラー数、応答時間、名前の順に並べたツール。
get_tool	1つのツールについて、失敗の理由、拒否された引数、応答サイズ、定義の変更、繰り返し、および各失敗の直前に行われた呼び出し。
list_errors	最新の失敗した呼び出しと、失敗の種類およびメッセージ。
list_unknown_tools	エージェントが求めた、サーバーにないツール、そのサーバーにある最も近いツール、およびエージェントが次に行ったこと。
list_clients	各クライアントの呼び出し数、エラー率、応答時間。
compare_versions	サーバーの各リリースを並べて比較します。
get_tool_listing	エージェントに表示された内容。使われていないツールと、その定義にかかったコスト。
list_sessions	失敗や繰り返しの呼び出しを含む、最近のセッション。
get_session	1つのセッション内の呼び出しを、順番に表示します。

トークンは Settings → Read tokens からいつでも取り消せます。取り消すと、エージェントはすぐにアクセスできなくなります。

ライセンス

MIT