mcpspan

mcpspan-mcp

向你的 AI Agent 询问 MCP 服务的情况。Claude Code、Cursor 或任何其他 MCP 客户端都可以根据你的 mcpspan 数据作答：

• 本周哪些工具失败最多，原因是什么？
• 1.4.1 与 1.4.0 相比如何？
• Agent 请求了哪些我的服务不具备的功能？
• Cursor 的失败频率是否高于 Claude？
• 哪些工具展示给了 Agent，却从未被调用？

它使用的令牌只能查看你在仪表板中看到的数据，不会更改任何内容。它不会将任何内容发送到 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：过去一天发生了什么问题？

获取令牌

在 mcpspan 中，打开设置 → 读取令牌并创建一个令牌。令牌只会显示一次，已填入下方的代码行中，可直接复制。

将其添加到你的 Agent

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 或更高版本。如果 Agent 通过互联网访问你的安装实例，请在其前面配置 HTTPS：每个问题都会携带令牌。

设置

变量
MCPSPAN_READ_TOKEN	读取令牌。必填。
MCPSPAN_URL	自托管 mcpspan 的 API 地址。若未设置，则使用 https://api.mcpspan.com。

需要 Node 20 或更高版本。

工具

所有工具都只读取数据。每个工具都可以通过名称或 ID 指定服务（若账号只有一个服务，则可省略），并指定时间范围：从现在起往前计算的 days 天（若省略，则为 7 天），或 from 和 to。

工具	可回答的问题
list_servers	该账号报告数据的服务。
get_overview	调用次数、失败次数、错误率、响应时间和客户端。
list_tools	按调用次数、错误数、响应时间或名称排序的工具。
get_tool	单个工具的失败原因、被拒绝的参数、回答长度、定义变更、重复调用，以及每次失败前的调用。
list_errors	最近失败的调用，包括失败类型和消息。
list_unknown_tools	Agent 请求但服务不具备的工具、最接近的现有工具，以及 Agent 接下来的操作。
list_clients	各客户端的调用次数、错误率和响应时间。
compare_versions	并排比较服务的各个版本。
get_tool_listing	展示给 Agent 的内容：从未使用的工具及其定义的开销。
list_sessions	最近的会话，包括失败和重复调用。
get_session	单个会话中的调用，按顺序排列。

可随时在设置 → 读取令牌下撤销令牌；Agent 会立即失去访问权限。

许可证

MIT