组件关系
Excel MCP Server
ExcelMCPClient
McpExcelToolDiscoveryService
McpExcelToolConfig
DefaultToolRegistry
OpenAiChatModel
ToolCallingManager
工具调用阶段
需要工具调用
不需要工具调用
OpenAiChatModel处理
大模型请求
ToolCallingManager判断是否需要工具调用
匹配可用工具
调用ExcelMCPClient.callTool
构建SSE请求
发送到Excel MCP Server
接收SSE响应
解析工具执行结果
返回给OpenAiChatModel
生成最终响应
启动阶段
Spring容器初始化
应用启动
McpExcelToolDiscoveryService初始化
调用MCP Server的/capabilities接口
解析工具元数据
存储工具定义到Map
McpExcelToolConfig初始化
注入McpExcelToolDiscoveryService
获取所有工具定义
注册工具到DefaultToolRegistry
OpenAiModelConfig初始化
创建ToolCallingManager
创建OpenAiChatModel

流程图说明

启动阶段

  1. 应用启动:Spring Boot应用程序启动
  2. Spring容器初始化:创建并初始化所有Spring Bean
  3. McpExcelToolDiscoveryService初始化
    • 调用MCP Server的/capabilities接口获取工具元数据
    • 解析并存储工具定义到内部Map中
  4. McpExcelToolConfig初始化
    • 注入McpExcelToolDiscoveryService
    • 获取所有工具定义并注册到DefaultToolRegistry
  5. OpenAiModelConfig初始化
    • 创建ToolCallingManager
    • 创建OpenAiChatModel并配置ToolCallingManager

工具调用阶段

  1. 大模型请求:用户发送请求到应用程序
  2. OpenAiChatModel处理:接收并处理请求
  3. ToolCallingManager判断:判断是否需要调用工具
  4. 工具匹配:如果需要调用工具,匹配可用的工具
  5. ExcelMCPClient调用:调用ExcelMCPClient的callTool方法
  6. 构建SSE请求:构建Server-Sent Events请求
  7. 发送请求:发送请求到Excel MCP Server
  8. 接收响应:接收SSE响应
  9. 解析结果:解析工具执行结果
  10. 返回结果:将结果返回给OpenAiChatModel
  11. 生成响应:生成最终响应返回给用户

组件关系

  • ExcelMCPClient:与Excel MCP Server通信的客户端
  • McpExcelToolDiscoveryService:动态发现Excel MCP Server的工具
  • McpExcelToolConfig:将动态工具注册到Spring AI中
  • OpenAiChatModel:处理大模型请求
  • ToolCallingManager:管理工具调用
  • DefaultToolRegistry:注册和管理所有可用工具
  • Excel MCP Server:外部服务,提供Excel操作工具

技术要点

  1. 动态工具发现:通过调用MCP Server的/capabilities接口动态获取工具定义
  2. 工具注册:将动态发现的工具注册到Spring AI的DefaultToolRegistry
  3. SSE通信:使用Server-Sent Events与Excel MCP Server通信
  4. 异步处理:使用AtomicReference和CountDownLatch处理异步响应
  5. 超时控制:设置超时机制确保请求不会无限等待

配置说明

  • application.yml中配置Excel MCP Server的URL和超时时间
  • bootstrap.yml中设置allow-bean-definition-overriding: true允许Bean定义覆盖
  • 通过McpExcelToolConfig控制工具的注册和管理

这个流程图清晰地展示了从应用启动到工具调用的完整流程,包括各个组件之间的关系和交互方式。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐