Spring AI项目中MCP工具列表调用异常问题解析

问题现象

在使用Spring AI项目的MCP（Model Context Protocol）组件时，开发者可能会遇到一个典型的异常情况：当尝试通过Spring MCP客户端调用服务端的工具列表接口时，系统抛出"Method not found: tools/list"错误。这个错误通常发生在开发者配置了MCP服务端和客户端但未正确注册工具Bean的情况下。

异常分析

从技术角度看，这个异常属于协议层面的方法未找到错误。MCP协议定义了一系列标准方法调用，其中"tools/list"是一个核心接口，用于获取服务端注册的所有可用工具列表。当客户端发起这个请求时，服务端如果无法找到对应的处理方法就会返回此错误。

根本原因

经过深入分析，这个问题的主要根源在于服务端缺少必要的工具注册配置。MCP服务需要明确知道哪些工具类应该被暴露给客户端调用，这需要通过Spring的依赖注入机制来完成。具体来说，开发者需要：

1. 创建一个实现业务逻辑的工具服务类
2. 将该服务类通过特定的Bean配置暴露给MCP框架
3. 确保工具类的方法符合MCP的调用规范

解决方案

正确的解决方法是创建一个ToolCallbackProvider Bean来注册你的工具服务。以下是典型的配置示例：

@Bean
public ToolCallbackProvider yourMCPTools(YourMCPService mcpService) {
    return MethodToolCallbackProvider.builder()
           .toolObjects(mcpService)
           .build();
}

这个配置的关键点在于：

• 使用MethodToolCallbackProvider构建器模式
• 通过toolObjects方法注册你的服务实例
• 确保服务类中的方法符合工具调用的签名要求

版本注意事项

值得注意的是，在Spring AI 1.0.0-M7及后续版本中，项目的starter artifact名称发生了变化。开发者升级时需要参考官方文档进行相应的调整，否则可能会出现类找不到等兼容性问题。

改进建议

虽然当前问题可以通过上述配置解决，但从框架设计角度，这个错误信息确实存在改进空间：

1. 错误信息可以更加明确地指出是服务端工具未注册
2. 可以提供更详细的文档说明工具注册的必要性
3. 框架可以在启动时检查工具注册情况并给出警告

总结

Spring AI的MCP组件提供了强大的模型上下文协议支持，但在使用时需要注意完整的工具注册流程。通过正确配置ToolCallbackProvider Bean，开发者可以避免"Method not found"这类错误，确保工具列表接口的正常工作。随着框架的迭代更新，开发者也需要关注版本变更带来的配置变化，及时调整项目依赖和配置方式。