评测与安全工具
mcp-probe:检测与健康检查 Model Context Protocol 服务器的命令行工具
itguruhaseeb/mcp-probe · Lint and health-check any Model Context Protocol (MCP) server over stdio — handshake, tools/list, JSON Schema validation, latency, safe round-trips.
ELI5:它是什么,解决什么问题
mcp-probe 是一个基于 Node.js 的命令行工具,通过 stdio 直接使用 MCP 线路协议(换行分隔的 JSON-RPC 2.0)对任意 Model Context Protocol 服务器进行 lint 与健康检查。它执行握手初始化、调用 tools/list 校验工具 inputSchema 是否符合 JSON Schema、检查 resources 与 prompts 声明、测量延迟,并可选地执行安全往返调用。工具提供人类可读报告、JSON 和 SARIF 输出,具备稳定的退出码和规则 ID,适合在 CI 中作为构建门禁。
核心能力与快速开始
★ 0 · JavaScript
- 能做什么
- 通过 stdio 使用换行分隔的 JSON-RPC 2.0 直接与 MCP 服务器通信,执行 initialize 握手并报告服务器名称、版本、协商协议版本与声明的能力;调用 tools/list 对每个工具的 inputSchema 做 JSON Schema 校验(type、properties、required 等),并警告缺失 description、title 或安全注解;在服务器声明 resources/prompts 能力时调用对应 list 并统计数量;测量握手与各 list 调用的延迟;通过 --call 对无必需参数的工具执行真实 tools/call 安全往返;支持 --json 与 --sarif 2.1.0 机器可读输出,提供稳定退出码与规则 ID 供 CI 过滤与计数。
- 适用场景
- 在开发或 CI 流程中对自研 MCP 服务器进行 lint 与冒烟测试,提前发现工具 inputSchema 漂移或格式错误;用稳定退出码和 JSON 输出作为构建门禁,阻止不符合规范的服务器发布;通过 SARIF 输出与 GitHub 代码扫描集成,将合规发现转化为拉取请求上的注解;对已部署的 MCP 服务器测量握手与列表调用延迟,排查慢服务器。
- 项目形态
- 可直接使用的工具
- 部署方式
- 未说明
- 主要依赖
- 需要 Node.js 18 或更高版本;通过 npx 运行无需安装。
- 使用限制
- 默认仅支持 stdio 传输,HTTP 和 SSE 传输在路线图中;--call 仅对无必需参数的工具执行往返,带有必需参数的工具会被跳过;更深层的 JSON Schema 校验(如嵌套 $ref、oneOf/anyOf、格式检查)尚在路线图中;未说明 API 成本或其他使用限制。
- 许可证
- MIT
- 最近推送
- 2026-10-01 22:20
资料检查:2026-10-02 07:00 · 卡片整理:2026-10-02 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容
职业应用
程序员
在开发或维护 MCP 服务器时,用 mcp-probe 对服务器进行 lint 与健康检查:执行握手初始化、调用 tools/list 校验工具 inputSchema 是否符合 JSON Schema、检查 resources 与 prompts 声明、测量延迟,并可选执行安全往返调用;通过 --json 或 --sarif 输出在 CI 中作为构建门禁,非零退出码可阻断不健康的服务器。
查看内容依据
mcp-probe 是一个基于 Node.js 的命令行工具,通过 stdio 直接使用 MCP 线路协议(换行分隔的 JSON-RPC 2.0)对任意 Model Context Protocol 服务器进行 lint 与健康检查。
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。