mcpspan 是专门面向 MCP 服务器的自托管分析工具,最新版本为 all/v0.7.0。MCP 服务器是向智能体客户端(Claude、Codex、Cursor 等)提供工具(tool)、资源(resource)和提示(prompt)的服务器。mcpspan 记录其中哪个客户端调用了哪个条目、调用有多慢以及为何失败。由于没有关于 all/v0.7.0 变更内容的公开说明,这里只介绍仓库中有文档记载的功能。
这个工具填补的是智能体运维中的可观测性空白。使用 MCP 服务器的团队很难知道哪些工具慢、哪些调用失败、哪些东西在反复出现。mcpspan 记录工具调用、资源读取和提示请求的使用量与响应时间,让你查看调用结果、错误类型以及单次会话内的重复调用,并比较不同服务器版本之间的差异。它还跟踪展示给智能体的工具定义消耗了多少 token。主要语言是 TypeScript,许可证为 MIT。
实现按多种语言拆分。它为 TypeScript、Python、Go、C#、Java、Rust、Ruby、PHP 提供连接工具,并配套统一的符合性测试套件(conformance test suite),以便用同样的方式检查不同语言实现的服务器之间的行为差异。数据保留在你所配置的服务器内部,支持 CSV 和 NDJSON 导出以及 OpenTelemetry 传输。
不过,证据不足的地方也很明显。该仓库有 18 个星标,研究记录中的动量分数偏低,只有 1.2 分,因此它更接近早期阶段的项目,而不是被广泛使用的工具。公开资料中没有给出延迟和 token 消耗应该处于何种水平的基准,也没有说明不同语言的服务器是否在同等水平上运行。由于数据留在服务器内部,向外传递的情况很少,但相应地也没有可比较的对象。对于已经在运行 MCP 服务器的团队来说,把它当作确认什么慢、什么在重复的起点,还是可以一试的。