1. 为什么 RooCode 接 NacosMCP 时 Key 总是配得一团乱如果你正在用 Spring AI Alibaba 做本地联调大概率会遇到这样一个场景Java 写了一个 MCP Server 注册到 NacosPython 又写了一个 MCP Server 也注册到 Nacos然后 RooCode 里要同时挂上这两个 Server还要再挂一个模型服务。结果就是每个工具、每个 Server、每个模型各要一份 Key散落在settings.json、config.toml、环境变量、.env文件里改一次要翻五个地方。RooCode 本身是一个 VS Code 里的 AI 编码插件支持通过 MCP 协议挂载外部工具。NacosMCP 是 Nacos 3.0 之后推出的 MCP Registry 能力让 MCP Server 可以像微服务一样注册到 Nacos支持动态上下线、工具开关热更新。Spring AI Alibaba 则提供了spring-ai-alibaba-starter-nacos-mcp-server这个 starter让 Java 开发者几行配置就能把带Tool注解的方法暴露成 MCP 工具。问题出在统一入口这件事上。Nacos 解决了服务发现的统一但没有解决模型调用的统一。RooCode 每次调用工具、每次请求模型都要走一遍鉴权。如果模型侧用的是 TaoToken 这类统一 API 网关就可以把模型 Key 收敛成一份MCP Server 的地址则交给 Nacos 管。这样 RooCode 侧只需要维护一份 Key 和一份 MCP Server 列表配置量直接砍半。这篇面向的是本地联调场景Docker 起 NacosJava 和 Python 各写一个 MCP Server 注册上去RooCode 通过mcp_setting.json挂载模型调用统一走 TaoToken。目标是一次配置跑通整条调用链不用来回改 Key。2. TaoToken 前置把模型 Key 收敛成一份在动手配 RooCode 之前先把模型侧的入口定下来。TaoToken 提供的是 OpenAI 兼容的 API 网关官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它的作用是让你用一份 Key 访问多个模型RooCode 里配置一次就能切换模型不用每个模型单独申请。具体操作路径是这样的先到控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 API Key然后在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 复制出来。这个 Key 后面会填到 RooCode 的模型配置里MCP Server 那边不需要再配模型 Key因为 MCP 只负责工具调用模型请求由 RooCode 统一发出。这里有个容易踩的坑很多人会把模型 Key 也塞进 MCP Server 的配置里觉得反正都要鉴权。但 MCP Server 的职责是暴露工具它不直接调模型。RooCode 收到工具返回结果后再带着模型 Key 去请求 TaoToken。所以 MCP Server 侧只需要 Nacos 的账号密码模型 Key 只出现在 RooCode 一处。如果你还没决定用哪个模型可以先到模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 试一下确认模型能正常返回再往下配。长期做编码和 Agent 的话Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 有更细的套餐说明本地联调阶段用按量计费就够了。3. 可复制配置Nacos 双语言 MCP Server RooCode这一节是全文的核心按顺序给出 docker-compose、Java 侧配置、Python 侧配置、RooCode 侧配置。每一步都可以直接复制。3.1 docker-compose 起 Nacos 3.0Nacos 3.0 之后鉴权参数变了NACOS_AUTH_IDENTITY_KEY、NACOS_AUTH_IDENTITY_VALUE、NACOS_AUTH_TOKEN三个必须配否则控制台登录会报错。下面这份 compose 文件可以直接用services: nacos: image: nacos/nacos-server:latest container_name: nacos-standalone environment: - PREFER_HOST_MODEhostname - MODEstandalone - NACOS_AUTH_IDENTITY_KEYserverIdentity - NACOS_AUTH_IDENTITY_VALUEsecurity - NACOS_AUTH_TOKENVGhpc0lzTXlDdXN0b21TZWNyZXRLZXkwMTIzNDU2Nzg volumes: - ./standalone-logs/:/home/nacos/logs - ./init.d/custom.properties:/home/nacos/init.d/custom.properties ports: - 8080:8080 - 8848:8848 - 9848:9848启动命令就一行docker-compose up -d起来之后访问http://localhost:8080进控制台默认账号密码都是nacos。如果登录报身份认证失败八成是NACOS_AUTH_TOKEN没配或者长度不够这个 token 需要 Base64 编码且解码后至少 32 位。3.2 Java 侧Spring AI Alibaba 注册 MCP Server依赖引入这块spring-ai-alibaba-starter-nacos-mcp-server要排除commons-logging否则和 logback 冲突dependency groupIdcom.alibaba.cloud.ai/groupId artifactIdspring-ai-alibaba-starter-nacos-mcp-server/artifactId version1.0.0.1/version exclusions exclusion artifactIdcommons-logging/artifactId groupIdcommons-logging/groupId /exclusion /exclusions /dependency dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-mcp-server-webmvc/artifactId version1.0.0-RC1/version /dependency dependency groupIdch.qos.logback/groupId artifactIdlogback-classic/artifactId version1.5.18/version /dependency工具类用一个天气服务做示例Tool注解的方法会被自动扫描import org.springframework.ai.tool.annotation.Tool; import org.springframework.ai.tool.annotation.ToolParam; import org.springframework.stereotype.Service; Service public class WeatherService { Tool(description Get weather information by city name) public String getWeather(ToolParam(description City name) String cityName) { return Sunny in cityName; } }application.yml里把 Nacos 注册打开注意server-addr和namespace要和你的 Nacos 实例一致server: port: 8081 spring: application: name: springboot-nacos-mcp ai: mcp: server: name: webmvc-mcp-server version: 1.0.0 type: SYNC alibaba: mcp: nacos: server-addr: localhost:8848 namespace: public username: nacos password: nacos registry: enabled: true启动类里把WeatherService注册成ToolCallbackProviderSpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } Bean public ToolCallbackProvider weatherTools(WeatherService weatherService) { return MethodToolCallbackProvider.builder().toolObjects(weatherService).build(); } }启动后到 Nacos 控制台的 MCP 列表里应该能看到webmvc-mcp-server点进去能看到getWeather这个工具。Nacos 还支持在控制台动态改工具描述和开关改完运行时直接生效不用重启 Java 服务。3.3 Python 侧nacos-mcp-wrapper-pythonPython 环境要求 3.12先装包pip install nacos-mcp-wrapper-python代码结构很直白NacosMCP实例化时传入 Nacos 地址和端口mcp.tool()装饰器注册工具from nacos_mcp_wrapper.server.nacos_mcp import NacosMCP from nacos_mcp_wrapper.server.nacos_settings import NacosSettings nacos_settings NacosSettings() nacos_settings.SERVER_ADDR 127.0.0.1:8848 nacos_settings.USERNAME nacos nacos_settings.PASSWORD nacos mcp NacosMCP(nacos-mcp-python, nacos_settingsnacos_settings, port18001) mcp.tool() def add(a: int, b: int) - int: Add two integers together return a b mcp.tool() def minus(a: int, b: int) - int: Subtract two numbers return a - b if __name__ __main__: try: mcp.run(transportsse) except Exception as e: print(fRuntime error: {e})跑起来之后Nacos 控制台会多一个nacos-mcp-python工具列表里有add和minus。同样支持动态开关。3.4 RooCode 侧mcp_setting.json 挂载两个 ServerRooCode 的 MCP 配置在mcp_setting.json里把两个 Server 的 SSE 地址填进去{ mcpServers: { nacos-mcp-python: { url: http://localhost:18001/sse, type: sse, alwaysAllow: [], disabled: false }, webmvc-mcp-server: { url: http://localhost:8081/sse, type: sse, alwaysAllow: [], disabled: false } } }模型侧在 RooCode 的设置里选 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那份。这样 RooCode 调模型走 TaoToken调工具走本地 MCP Server两条链路互不干扰。4. 验证请求一次连通性检查跑通调用链配置写完先别急着在对话里让模型算数按顺序做三步验证出问题好定位。第一步确认 Nacos 里两个 Server 都在线。打开http://localhost:8080进 MCP 列表webmvc-mcp-server和nacos-mcp-python的状态应该是健康。如果某个 Server 显示离线先看它的进程日志Java 侧常见的是 Nacos 地址写错或者 namespace 不匹配Python 侧常见的是端口被占用。第二步确认 RooCode 里 MCP Server 图标变绿。RooCode 的 MCP 面板里每个 Server 前面有个状态点绿色表示 SSE 连接成功。如果一直是灰色或者红色点开看错误信息多半是 URL 写错或者 Server 没起来。第三步在 RooCode 对话里发一条工具调用请求比如使用 demo 工具计算 100 和 201 的和。正常的话 RooCode 会先请求 TaoToken 的模型模型返回一个add工具调用RooCode 转发给nacos-mcp-python拿到 301再回给模型最后输出结果。整个过程在 RooCode 的调用日志里能看到完整的 tool call 链路。再试一条天气的查一下北京的天气。这条会走webmvc-mcp-server的getWeather返回Sunny in 北京。两条都通了说明 Java 和 Python 两个 Server 都被 RooCode 正确挂载模型侧也正常。如果你在 Nacos 控制台把getWeather这个工具临时禁用再发一次天气请求RooCode 会报工具不可用。这说明动态开关生效了运行时改配置不用重启服务。5. 本篇常见错排查Nacos 控制台登录报身份认证失败检查NACOS_AUTH_TOKEN是否配置且 Base64 解码后长度 ≥ 32 位。NACOS_AUTH_IDENTITY_KEY和NACOS_AUTH_IDENTITY_VALUE也要成对出现缺一个都会失败。Java MCP Server 启动后 Nacos 里看不到先确认spring.ai.alibaba.mcp.nacos.registry.enabled是true再确认server-addr能 ping 通。如果 Nacos 开了鉴权username和password必须填默认的nacos/nacos在 3.0 之后可能被改过。Python 侧nacos-mcp-wrapper-python装不上确认 Python 版本 ≥ 3.12低版本会缺依赖。如果公司网络有 pip 源限制换官方源或者内网镜像。RooCode 里 MCP Server 图标不绿先手动curl http://localhost:8081/sse看有没有响应没有响应说明 Server 没起来。有响应但 RooCode 连不上检查mcp_setting.json的 JSON 格式多一个逗号都会导致整个文件解析失败。工具调用返回了但模型没继续这种情况多半是模型侧的问题检查 RooCode 里 TaoToken 的 Base URL 是不是https://taotoken.net/apiKey 有没有多余空格。可以到模型对话页面单独测一下模型是否正常。动态改工具描述后 RooCode 没更新RooCode 的 MCP 连接是长连接Nacos 侧改了之后需要 RooCode 重新拉一次工具列表。在 MCP 面板里点一下刷新或者重启 RooCode 窗口。6. 把 Key 和 Server 分开管联调才不累整条链路跑通之后你会发现配置其实就三块Nacos 管 MCP Server 的注册和发现RooCode 管工具挂载和模型请求TaoToken 管模型 Key 的统一入口。三块各司其职改任何一块都不影响另外两块。本地联调阶段最省事的做法是Nacos 用 docker-compose 一键起Java 和 Python 的 MCP Server 各跑各的端口RooCode 的mcp_setting.json里只维护 Server 列表模型 Key 只在 RooCode 设置里填一次。这样你新增一个 MCP Server只需要在 Nacos 注册 在 RooCode 加一条配置不用动模型侧。如果你后面要接更多模型或者做 Agent 编排可以到 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 看长期方案。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 OpenAI 兼容接口的详细说明。Claude Code 相关的配置在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 如果你同时用 Claude Code 做编码可以参考那份配置把 Key 也统一过来。最后留一个实用技巧Nacos 控制台里可以给每个 MCP Server 打标签联调时按标签筛选比在一堆 Server 里翻要快得多。工具描述尽量写清楚参数含义模型选工具时准确率会高不少。