1. 为什么要把本地工具塞进 MCP Server 再统一走一个 KeyMCP Server 说白了就是一层“工具插座”AI 客户端Claude Code、Cursor、Cline 这类通过标准协议问它“你有哪些工具”它把本地方法暴露出去客户端决定什么时候调、传什么参数。SpringBoot 写 MCP Server 的好处是你团队里现成的 Service、Mapper、鉴权、日志、事务全都能直接复用不用为了接 AI 再单独起一套 Python 脚本。但真正落地时麻烦往往不在“工具怎么写”而在“模型从哪来”。本地工具跑通了客户端要调模型你得给每个客户端配一遍 Base URL、Key、模型名换一个模型又要改一轮配置。我试过同时维护 Cursor、Cline、Claude Code 三套配置改一次 Key 要翻三个文件特别容易漏。所以这篇的思路是SpringBoot 负责把本地工具用 MCP 协议暴露出来模型通道统一收敛到 TaoToken 的 Key/API 上。TaoToken 是一个兼容 OpenAI/Anthropic 风格接口的模型聚合通道你拿一个 Key 就能在多个客户端里调不同模型MCP Server 本身不碰模型只负责工具客户端那边统一填 TaoToken 的地址和 Key。这样职责清晰工具归工具模型归模型。适合谁看有 SpringBoot 基础、想把公司内部接口员工查询、订单、工单、知识库接给 AI 客户端的后端同学或者已经在用 Cursor/Cline但被多套 Key 配置搞烦的人。下面从依赖开始一步步给可复制的代码和配置。2. 前置准备JDK、依赖与 TaoToken Key 通道先说环境。JDK 必须 17 及以上Spring AI 的 MCP starter 对版本有硬要求JDK 8 直接编译不过。IDEA 用 2023 以后的版本Maven 3.8。我本地是 JDK 21 Spring Boot 3.3.x跑下来没问题。Maven 依赖这块要选对 starter。Spring AI 提供了三个 MCP Server 包协议支持不一样选错了要么起不来要么客户端连不上starter 包名支持的传输协议适用场景spring-ai-starter-mcp-serverstdio本地进程间通信客户端拉起进程spring-ai-starter-mcp-server-webmvcsseHTTP 远程通信Web 环境spring-ai-starter-mcp-server-webfluxsse响应式栈WebFlux 项目我们做的是能被 Cursor、Cline 通过 URL 连的远程 Server所以用 webmvc 这个。pom 里加dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-mcp-server-webmvc/artifactId version1.0.0/version /dependency注意版本号Spring AI 1.0.0 是 GA 版本MCP 相关 API 在这个版本才稳定。如果你用的是里程碑版本Tool注解的包路径可能不一样建议直接对齐 1.0.0。然后是 TaoToken 的 Key。打开 https://taotoken.net/api 对应的控制台进 API Keys 页面创建一个 Key复制出来先存好。这个 Key 后面要填到客户端的模型配置里不是填到 SpringBoot 里——MCP Server 本身不调模型所以它不需要这个 Key。这一点很多人第一次会搞混以为 MCP Server 要配模型 Key其实模型调用发生在客户端侧MCP Server 只提供工具。顺手把接入文档也开一个标签页https://taotoken.net/doc 里面写了 Base URL 和模型 ID 的对应关系等会儿配客户端要用。Base URL 统一是https://taotoken.net/api注意不要带 UTM 参数客户端配置里带参数有的会解析失败。3. 可复制配置application.yml 与 MCP 工具注册先写application.yml。MCP Server 的配置全在spring.ai.mcp.server下面server: port: 18888 spring: ai: mcp: server: name: local-tool-server version: 1.0.0 stdio: false sse-endpoint: /sse enabled: true type: SYNC几个关键点解释一下。stdio: false是禁用标准输入输出协议因为我们走 HTTPsse-endpoint: /sse指定 SSE 端点路径客户端就连http://127.0.0.1:18888/ssetype: SYNC表示同步工具调用简单场景够用如果你工具里有耗时操作再考虑 ASYNC。端口我用了 18888你按自己习惯改别和现有服务冲突。接下来是工具类。用Tool注解标记方法注解目前只支持方法维度类上标没用。写一个员工服务的例子Service public class EmployeeServiceImpl implements EmployeeService { Autowired private EmployeeMapper employeeMapper; Override Tool(name getEmployeeInfo, description 根据员工ID获取员工详细信息) public Employee getEmployeeInfo(String employeeId) { return employeeMapper.selectById(employeeId); } Override Tool(name getEmployeeList, description 获取全部员工列表) public ListEmployee getEmployeeList() { return employeeMapper.selectList(null); } Override Tool(name addEmployee, description 新增一名员工参数为员工对象) public boolean addEmployee(Employee employee) { return employeeMapper.insert(employee) 0; } Override Tool(name updateEmployee, description 更新员工信息按ID匹配) public boolean updateEmployee(Employee employee) { return employeeMapper.updateById(employee) 0; } }description一定要写清楚模型是靠这个判断什么时候调哪个工具的。写“获取员工信息”就比写“查询”强很多参数含义也尽量在描述里点出来。然后是注册配置类把工具对象交给 MCP ServerConfiguration public class McpConfig { Bean public ToolCallbackProvider toolCallbackProvider(EmployeeService employeeService) { return MethodToolCallbackProvider.builder() .toolObjects(employeeService) .build(); } }toolObjects可以传多个对象比如你还有 OrderService、TicketService逗号隔开一起塞进去它们上面的Tool方法都会被注册。启动 SpringBoot控制台会打印注册的工具数量看到 4 个就对了。4. 验证请求curl 拉工具列表 客户端调用链路服务起来后先别急着开客户端用 curl 验证 SSE 端点通不通curl -N http://127.0.0.1:18888/sse-N是关闭缓冲你会看到一条event: endpoint的数据流里面带一个 sessionId类似event: endpoint data: /mcp/message?sessionId8f3a...这说明 SSE 通道建立成功。接着用这个 sessionId 发一个初始化请求curl -X POST http://127.0.0.1:18888/mcp/message?sessionId8f3a... \ -H Content-Type: application/json \ -d { jsonrpc: 2.0, id: 1, method: tools/list, params: {} }返回里应该能看到getEmployeeInfo、getEmployeeList这些工具名和它们的参数 schema。这一步过了说明 MCP Server 侧完全正常。然后配客户端。以 Cursor 为例在 MCP 配置里加{ mcpServers: { local-tool-server: { url: http://127.0.0.1:18888/sse, type: sse } } }刷新后能看到 4 个 tools 挂上来了。但这时候模型还没配。Cursor 的模型设置里把 Base URL 填https://taotoken.net/apiAPI Key 填你在控制台建的那个模型 ID 按文档里写的填比如claude-sonnet-4-5这类。三件套齐了Base URL Key Model ID缺一个都会报错。配完在对话框里问“帮我查一下员工 ID 为 1001 的信息”模型会先调getEmployeeInfo拿到结果再组织语言回复。整条链路是客户端 → TaoToken 通道 → 模型 → 决定调工具 → 回到本地 MCP Server → 查数据库 → 结果回传。你可以在 SpringBoot 日志里看到工具被调用的记录确认链路真的走通了。5. 常见报错排查401、local proxy failed 与 OAuth配的时候踩过几个坑列出来对照。401 Unauthorized。这个基本是 Key 的问题。检查三处Key 有没有复制全前后别带空格、Base URL 是不是https://taotoken.net/api别写成带/v1或带 UTM 的、客户端里模型 ID 和 Key 是不是配在同一处。如果 Key 是在别的项目里用的确认它没被删或者额度没用完。local proxy failed / connection refused。客户端连不上 MCP Server。先确认 SpringBoot 真的起来了curl http://127.0.0.1:18888/sse有没有响应。如果服务在远程机器上127.0.0.1要换成实际 IP并且防火墙放行端口。还有一种情况是客户端配置里type写成了stdio但 URL 是 HTTP 的协议对不上也会报这个。reading choices 相关报错。这通常是模型返回格式和客户端预期不一致多半是 Base URL 或模型 ID 填错了客户端拿到的不是标准响应。回到 TaoToken 文档核对模型 ID 拼写确认 Base URL 没多斜杠。OAuth 报错。有些客户端默认走 OAuth 流程但 TaoToken 用的是 API Key 鉴权。在客户端设置里找“使用 API Key”或“自定义 Header”的选项把鉴权方式切成 Key别让它去走 OAuth。工具列表为空。SSE 连上了但看不到 tools检查McpConfig里的toolObjects有没有真的注入进来Tool注解的包是不是org.springframework.ai.tool.annotation.Tool。注解导错包是最常见的导成别的同名注解就不会被扫描。排查顺序建议先 curl 确认 Server 活着再看客户端 MCP 连接状态最后查模型 Key 配置。三段分开定位比一股脑改配置快得多。6. 把通道固定下来长期编码与 Agent 场景的配置建议工具和模型都跑通之后建议把配置固定成模板别每次重配。MCP Server 这边application.yml里的端口、端点路径、工具注册类基本不变团队里可以抽成一个公共 starter各个业务模块只写自己的Tool方法。模型通道这边如果你只是偶尔验证一下工具调用用模型对话页面手动试就行https://taotoken.net/model-chat 。但如果是长期在 Cursor、Cline 里写代码、跑 Agent建议用 Coding Plan把 Key 和额度统一管理省得每个客户端单独配https://taotoken.net/coding-plan 。还有一个实用技巧把 MCP Server 的工具描述当成接口文档来维护。模型选错工具十有八九是description写得太模糊。我习惯在描述里带上参数示例比如“根据员工ID获取信息ID 形如 1001”模型调用准确率会明显提升。工具多了以后按业务域拆成多个ToolCallbackProviderBean也方便排查是哪个域的工具出了问题。最后Key 别硬编码在代码或提交到仓库里。客户端配置里的 Key 用环境变量注入SpringBoot 侧压根不存模型 Key这样即使代码泄露也不影响通道安全。整套跑下来本地工具通过标准协议暴露模型调用统一走一个 Key换模型只改客户端一处维护成本能降不少。