ModelContextProtocol TypeScript SDK 方法调用问题解析

问题现象

在使用ModelContextProtocol TypeScript SDK时，开发者遇到了一个典型的方法调用问题。具体表现为：在Node.js v22.14.0环境下，调用listTools和callTool方法能够正常工作，但尝试调用listResources、listPrompts和listResourceTemplates方法时却会抛出"McpError: MCP error -32601: Method not found"错误。

错误分析

这个错误属于RPC(远程过程调用)协议中的标准错误码-32601，表示请求的方法在服务器端不存在或未被实现。错误信息清晰地表明问题不在于客户端SDK本身，而是服务端实现不完整导致的。

技术背景

ModelContextProtocol是一个基于JSON-RPC的协议，它定义了客户端与服务端之间的通信规范。在这种架构中：

1. 客户端通过RPC调用向服务端发送请求
2. 服务端需要实现协议定义的所有方法
3. 当客户端请求未实现的方法时，服务端应返回方法未找到错误

解决方案

根据项目维护者的回复，这个问题并非SDK本身的bug，而是因为使用的服务端实现没有完整支持协议定义的所有方法。开发者可以采取以下措施：

1. 确认使用的服务端版本是否支持这些方法
2. 检查服务端文档，了解其实现的方法范围
3. 如果需要这些功能，考虑升级服务端或切换到完整实现的服务端版本

最佳实践建议

在使用RPC类SDK时，开发者应当：

1. 仔细阅读服务端实现的文档，了解其支持的方法范围
2. 在调用方法前，可以通过版本检查或能力协商机制确认服务端能力
3. 对可能不支持的方法调用添加适当的错误处理逻辑
4. 考虑在应用启动时进行服务端能力检测，避免运行时错误

总结

这个案例很好地展示了分布式系统中客户端与服务端版本兼容性的重要性。开发者在使用任何RPC框架时，都需要注意服务端实现可能不会完整支持协议定义的所有功能。通过理解协议规范和做好错误处理，可以构建更健壮的应用程序。