ModelContextProtocol Inspector 工具验证机制解析

问题现象

在使用ModelContextProtocol Inspector工具时，开发者可能会遇到一个特殊现象：即使工具返回了有效的响应结果，Inspector客户端仍然会显示"invalid tool"的错误提示。这种情况在使用天气MPC示例时尤为明显。

根本原因分析

经过深入排查，发现该问题源于Schema验证机制的不匹配。具体表现为：

1. Inspector客户端中的CallToolResultSchema.safeParse(toolResult)验证方法期望接收一个数组类型的数据结构
2. 然而在实际的天气应用示例中，工具返回的是一个包含JSON字符串的对象结构

技术细节

典型的错误响应结构如下所示：

{
  "content": {
    "mimeType": "application/json",
    "text": "[{\"date\":\"2024-11-27\",\"temperature\":16.19,\"conditions\":\"few clouds\"}]"
  }
}

而验证机制期望的应该是直接解析后的数组结构：

[
  {
    "date": "2024-11-27",
    "temperature": 16.19,
    "conditions": "few clouds"
  }
]

解决方案

该问题已被确认为文档错误，现已修复。开发者需要注意：

1. 工具实现时应直接返回数组结构，而非包含JSON字符串的对象
2. 确保返回的数据结构与Schema定义完全匹配
3. 对于复杂数据结构，建议在开发阶段进行充分的Schema验证测试

最佳实践建议

为避免类似问题，建议开发者在实现MPC工具时：

1. 仔细阅读最新版本文档中的类型定义
2. 在本地开发环境中预先进行Schema验证
3. 使用类型检查工具确保数据结构一致性
4. 对于返回JSON数据的情况，确保已正确解析为JavaScript对象

通过遵循这些实践，可以确保工具与Inspector客户端的完美兼容，避免验证错误的发生。