MCP工具兼容性实测：仅13.7%通过v0.4.2协议验证，附权威检测脚本

想用MCP快速搭Agent，`list_tools`直接报错？  
想把Cursor插件接入Claude Desktop，元数据字段全空、参数结构对不上？  
问题不在你的Server——90%标称“MCP”的工具，根本没跑通v0.4.2协议。

我们用自研检测脚本（[github.com/yitb/mcp-validator](https://github.com/yitb/mcp-validator)）扫描了mcphello.com全部1580+款标称MCP的工具：仅217个（13.7%）通过完整兼容性测试。不是“能连上”，而是真能过：  
✅ `list_tools` 返回非空数组，且每项含 `name`、`description`、`input_schema`  
✅ `execute_tool` 响应必须含 `result` 字段，或标准 `error` 结构（含 `type` 和 `message`）  
✅ `capabilities` 声明与实际能力一致（例如声明 `file_access: read`，就必须支持读取任意路径）  
✅ 工具ID在 `list_tools` 返回值与 `execute_tool` 请求体中严格一致  

断层集中在三处：  
1. **假`list_tools`**：62%的工具返回空数组或 `{}`，连自己有哪些工具都说不清；  
2. **元数据裸奔**：41%缺失 `input_schema`，Agent无法生成参数表单，你得手写JSON Schema去猜它要什么；  
3. **A2A链路断裂**：37%不校验 `tool_id` 合法性，传错ID直接静默失败——Server端连日志都抓不到错误源。




👉 <a href="https://idsoo.com/go/binance.html" rel="nofollow noopener" target="_blank">Binance</a> · <a href="https://idsoo.com/go/okx.html" rel="nofollow noopener" target="_blank">OKX</a> · <a href="https://idsoo.com/go/gate.html" rel="nofollow noopener" target="_blank">Gate.io</a> · <a href="https://idsoo.com/go/htx.html" rel="nofollow noopener" target="_blank">HTX</a> · <a href="https://idsoo.com/go/bitget.html" rel="nofollow noopener" target="_blank">Bitget</a>

这不是“体验差”，是商业落地的风险点。  
比如AI客服Agent：前端用Claude Desktop调用MCP查订单，后端Server需统一处理不同工具的响应。若一款工具返回 `{"data": "xxx"}`，另一款返回 `{"output": "xxx"}`，你就得为每种格式写分支逻辑。更麻烦的是，当客户反馈“查不到订单”，你根本分不清问题是出在工具实现、Server适配，还是Agent调用逻辑里。

yitb.com不收“标称MCP”的宣传费，只验协议是否真实跑通。我们已将217个通过验证的工具打标【✅ MCP v0.4.2 Full】，按场景分类（代码生成 / 数据库操作 / 文件处理 / HTTP调用），附实测响应样例和失败复现步骤。例如：  
- `sql-query-runner`（ID: sql-v1）：支持 `list_tools` → `execute_tool` → `get_result` 完整闭环，所有字段名、嵌套结构、错误码均符合Spec；  
- `cursor-file-reader`（ID: cursor-fs）：`list_tools` 返回 `input_schema` 但缺失 `required` 字段，导致Agent传参必报 `ValidationError`——我们已向作者提PR修复。

这不是挑刺，是帮你省掉上线前3天的协议对齐工时。所有检测脚本开源，支持一键验证本地工具：  

git clone https://github.com/yitb/mcp-validator
cd mcp-validator
pip install -r requirements.txt
python validator.py --endpoint http://localhost:8000/mcp

输出含：具体违规点、修复建议、兼容性得分（0–100）、是否推荐集成。

下一步：  
👉 访问 [yitb.com/mcp/verified](https://yitb.com/mcp/verified) 查看217个已验证工具清单（含GitHub链接、响应快照、Server对接配置模板）；  
👉 用validator脚本测你正在集成的MCP工具，5分钟内确认它是不是“真MCP”；  
👉 如果你维护MCP工具，提交PR到[yitb/mcp-validator](https://github.com/yitb/mcp-validator) 补充测试用例——通过后，我们将为你打标【Verified by yitb】并推送到龙虾官网Agent生态首页。