tooltest
MCP服务器协议一致性测试工具，兼顾开发调试与CI集成。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：tooltest。 它的用途是：MCP服务器协议一致性测试工具，兼顾开发调试与CI集成。 完整的 Skill 内容见：https://321skill.com/skills/tooltest/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请帮我测试本地刚开发的 MCP 服务器，看看协议有没有问题。’ 它会调用 tooltest，模拟客户端连接你的服务器，列出所有可用工具并尝试调用，最后生成一份包含任何协议错误、架构不匹配或运行时问题的清晰报告，帮助你快速定位修复点。
介绍
tooltest 是一款专为 MCP 服务器设计的协议一致性测试工具。它模拟真实客户端/智能体的行为（连接→列出工具→调用工具），并报告协议、架构或运行时问题，帮助开发者快速定位和修复。
使用方式非常灵活：你可以通过简单的命令行工具在本地快速进行冒烟测试，也可以在 CI/CD 流程中将其作为集成测试的一部分，确保每次发布的质量。它支持测试通过 stdio 或 HTTP 方式运行的 MCP 服务器。
这个工具非常适合 MCP 服务器的开发者、测试工程师以及运维工程师。无论是个人开发者在本地调试，还是团队在自动化流水线中保障代码质量，tooltest 都能提供可靠的验证。
建议在开发过程中频繁运行 tooltest 进行快速反馈。对于更复杂的修复流程，可以将其配置为 MCP 服务器，让编码智能体（如 Claude、Cursor）运行“修复-测试”循环，自动化处理常见问题。
核心特点
与通用 API 测试工具不同，tooltest 深度理解 MCP 协议规范，能执行状态机驱动的测试，精准发现协议合规性、JSON Schema 匹配及运行时交互问题。它速度极快，适合 CLI 即时反馈，同时输出结果结构化，便于 CI 集成和 AI 代理自动修复。
注意事项
主要专注于 MCP 服务器的协议和基础功能测试，不适用于测试服务器内部业务逻辑的复杂正确性或性能压测。
常见问题
tooltest 能测试哪些类型的 MCP 服务器？
支持测试通过 stdio（命令行）或 HTTP（Streamable）方式运行的 MCP 服务器。
如何在 CI/CD 中集成 tooltest？
将 tooltest 命令作为构建步骤运行，并根据其退出码（非零表示失败）来决定 CI 任务的成败。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/tooltest/raw/index.md 读取 tooltest 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/tooltest/raw/index.md（查看排版版本）