MCP-Doctor 是一款面向 Model Context Protocol(MCP)生态的自动化测试与校验框架,由社区开发者 sercanbayrambey 维护。它把"针对 MCP 服务器工具的体检"这件事做成了可重复执行的流水线:开发者只需声明被测 server 的接入方式(通常通过本地 stdio、SSE 或可执行的命令),框架便会自动探测其暴露的 tools、resources、prompts 列表,并按照 JSON Schema 对入参、返回值与错误结构做断言校验。
它能帮你做什么
- Schema 合规校验:自动核对工具描述、参数 schema、必填字段是否符合 MCP 协议规范,避免因字段缺失导致 Claude、Cursor 等客户端调用失败。
- 回归测试:把工具调用样例固化为测试用例,每次 MCP server 升级时一键回归,快速定位破坏性变更。
- 可观测输出:生成结构化的测试报告,覆盖调用耗时、payload 体积、错误率等指标,方便排查性能与稳定性问题。
- CI/CD 集成:可作为 CLI 在 GitHub Actions、GitLab CI 等流水线中串行运行,作为合并前的质量门禁。
是否需要密钥
MCP-Doctor 本身只对 MCP server 做协议层面的"打针体检",并不直接调用大模型,因此无需配置 LLM API Key。但若你的 MCP server 在内部依赖第三方服务(例如远端数据库、需要鉴权的 SaaS API),则需要在 server 端自行准备相应的访问令牌或凭证。MCP-Doctor 不会替你托管这些密钥,请将其放在本地的环境变量或密钥管理服务中,不要写入仓库明文。
具体支持的 MCP 传输方式、命令行参数与最新特性,请以官方 GitHub 仓库 sercanbayrambey/MCP-Doctor 的 README 为准。