r-nacos 内置 MCP Server 与接口转发：让普通 HTTP 接口直接变成 MCP 服务

1. 普通 HTTP 接口怎么零改造变成 MCP 服务如果你手上已经有一堆跑得好好的 HTTP 接口现在团队又想接 MCP 生态让 Claude、Cursor 这类客户端直接调用第一反应多半是「难道要把每个接口重写一遍 MCP Server」。我一开始也这么想后来发现 r-nacos 内置了 MCP Server 和接口转发能力思路就完全变了接口不用动注册到 r-nacos 之后由 r-nacos 把它转成 MCP 服务对外暴露。这篇就围绕 r-nacos 的 MCP Server 与接口转发来讲适合两类人一是后端团队手里有现成的 REST 接口想低成本接入 MCP二是平台团队想给内部服务统一加一层 MCP 网关。核心检索词就三个mcp server、r-nacos、http 接口转 mcp 服务。整套流程分四步走打开 r-nacos 的 MCP 开关、把 HTTP 接口注册进去、配置转发规则、用 MCP 客户端调用验证。全程不需要改你原来的接口代码改的是注册和转发配置。需要说明的是r-nacos 负责的是「注册 转发 协议转换」这一层它不替代你的业务接口也不替代编辑器或客户端。你原来的 HTTP 服务还是照常跑r-nacos 只是在中间做了一次协议适配。理解这一点后面的配置就不会绕。2. 前置准备r-nacos 与 MCP 开关2.1 确认 r-nacos 版本与 MCP 能力r-nacos 本身是个注册中心和配置中心内置 MCP Server 是它比较新的能力。先确认你部署的版本支持 MCP启动后在控制台能看到 MCP 相关的菜单或开关。如果你还没部署最省事的方式是用官方提供的单机模式先跑起来验证通了再上集群。启动命令大致如下具体参数按你的环境调整# 单机模式启动 r-nacos默认端口 8848 ./rnacos -m standalone启动后访问控制台默认地址是http://127.0.0.1:8848/rnacos/。进去之后先看两处一是服务列表确认你的 HTTP 接口能注册进来二是 MCP 配置区确认 MCP Server 开关存在。2.2 打开 MCP Server 开关MCP Server 默认不一定开启需要在配置里显式打开。在 r-nacos 的配置文件一般是conf/application.properties或环境变量里加上 MCP 相关配置# 开启内置 MCP Server rnacos.mcp.enabledtrue # MCP Server 对外监听端口避免和主端口冲突 rnacos.mcp.port8858 # 转发目标的基础路径前缀按需设置 rnacos.mcp.forward.prefix/api改完重启 r-nacos再看控制台MCP 状态应该变成「已启用」。这一步是整个方案的地基开关没开后面注册再多接口也不会被转成 MCP 服务。注意MCP 端口和 r-nacos 主端口要分开别图省事用同一个否则协议混在一起排查起来很痛苦。2.3 准备一个可用的 HTTP 接口为了后面验证方便先准备一个最简单的 HTTP 接口比如返回当前时间的接口# 假设你的接口跑在 8080 curl http://127.0.0.1:8080/api/time # 返回{now:2025-01-01T12:00:00Z}这个接口就是待会儿要被转成 MCP 服务的「原材料」。它不需要任何 MCP 相关依赖就是个普通 REST 接口。3. 可复制配置把 HTTP 接口注册并转发为 MCP 服务3.1 把 HTTP 接口注册到 r-nacosr-nacos 支持通过控制台或 OpenAPI 注册服务实例。这里用 OpenAPI 的方式方便脚本化。假设你的 HTTP 接口服务名是time-service实例地址是127.0.0.1:8080# 注册服务实例到 r-nacos curl -X POST http://127.0.0.1:8848/nacos/v1/ns/instance \ -d serviceNametime-service \ -d ip127.0.0.1 \ -d port8080 \ -d ephemeraltrue注册成功后在控制台的服务列表里能看到time-service并且有一个健康实例。这一步只是让 r-nacos 知道「有这么个 HTTP 服务存在」还没到 MCP 转换。3.2 配置接口转发规则关键在转发规则告诉 r-nacos 哪个 HTTP 路径要暴露成哪个 MCP 工具tool。在 MCP 配置区新增一条转发规则用 JSON 描述{ serviceName: time-service, mcpToolName: get_current_time, description: 获取服务器当前时间, httpMethod: GET, httpPath: /api/time, inputSchema: { type: object, properties: {}, required: [] } }几个字段的含义要拎清楚serviceName对应你刚注册的服务名mcpToolName是暴露给 MCP 客户端的工具名客户端就是靠这个名字调用的httpPath是原始 HTTP 接口路径inputSchema描述这个工具的入参没有参数就写空对象。如果接口需要参数比如查询某个用户信息inputSchema就要写清楚{ serviceName: user-service, mcpToolName: get_user_info, description: 根据用户 ID 查询用户信息, httpMethod: GET, httpPath: /api/user, inputSchema: { type: object, properties: { userId: { type: string, description: 用户唯一标识 } }, required: [userId] } }r-nacos 在转发时会把 MCP 调用里的userId参数拼到 HTTP 请求的 query 上也就是实际请求GET /api/user?userIdxxx。POST 接口同理参数会按配置映射到请求体。3.3 参数映射的几种常见形态不同接口的参数位置不一样转发规则里要对应处理。下面这张表是我实测下来最常用的几种映射接口参数位置HTTP 方法转发配置要点Query 参数GETinputSchema 属性直接映射到 query路径参数GEThttpPath 里用占位符如/api/user/{userId}JSON BodyPOST配置 body 映射属性名与接口字段一致Header 参数任意在规则里单独声明 header 映射路径参数的写法要特别注意占位符名字要和 inputSchema 里的属性名一致否则转发时会取不到值。4. 验证请求用 MCP 客户端调用确认转换成功4.1 用 MCP 客户端连接 r-nacos配置好转发规则后r-nacos 的 MCP Server 就已经把这个 HTTP 接口暴露成 MCP 工具了。接下来用任意支持 MCP 的客户端连接。以常见的 MCP 客户端配置为例在客户端的 MCP 配置里加上 r-nacos 的 MCP 地址{ mcpServers: { rnacos-gateway: { url: http://127.0.0.1:8858/mcp, transport: http } } }保存后重启客户端正常情况下能在工具列表里看到get_current_time这个工具。看到它说明 r-nacos 已经成功把 HTTP 接口转成了 MCP 服务。4.2 发起一次工具调用在客户端里直接让模型调用这个工具比如输入「现在几点了调用工具查一下」。客户端会向 r-nacos 的 MCP Server 发起tools/call请求r-nacos 收到后转发到http://127.0.0.1:8080/api/time拿到结果再按 MCP 协议返回。如果你想手动验证也可以用 curl 模拟一次 MCP 调用curl -X POST http://127.0.0.1:8858/mcp \ -H Content-Type: application/json \ -d { jsonrpc: 2.0, id: 1, method: tools/call, params: { name: get_current_time, arguments: {} } }返回结果里应该能看到content字段内容是原始 HTTP 接口返回的 JSON。到这一步整条链路就通了MCP 客户端 → r-nacos MCP Server → 转发 → 普通 HTTP 接口。4.3 带参数的调用验证再验证一个带参数的接口确认参数映射没问题curl -X POST http://127.0.0.1:8858/mcp \ -H Content-Type: application/json \ -d { jsonrpc: 2.0, id: 2, method: tools/call, params: { name: get_user_info, arguments: {userId: 1001} } }如果返回的是用户 1001 的信息说明 query 参数映射正确。如果返回报错或空数据多半是参数名对不上回到转发规则里核对inputSchema的属性名和接口实际接收的参数名。5. 本篇常见错排查5.1 工具列表里看不到注册的接口最常见的原因是 MCP 开关没生效或者转发规则没保存成功。先确认rnacos.mcp.enabledtrue且重启过再确认转发规则里的serviceName和实际注册的服务名完全一致大小写都别错。还有一种情况是服务实例不健康r-nacos 不会把不健康的实例暴露成工具去服务列表看实例状态。5.2 调用返回 404 或连接被拒这类错误基本出在转发目标上。检查httpPath是否写全比如接口实际是/api/v1/time你只写了/api/time就会 404。连接被拒则看实例的 ip 和 port 是否可达容器环境下127.0.0.1往往指向容器自己而不是宿主机要换成实际可达的地址。5.3 参数传了但接口收不到参数映射是高频坑。GET 接口的参数默认拼到 query如果你的接口是从 body 里读参数就要在转发规则里显式声明 body 映射。另外注意类型MCP 传过来的数字和字符串接口侧如果做了严格类型校验可能因为类型不匹配被拒。5.4 MCP 端口冲突如果 r-nacos 启动时报端口占用检查rnacos.mcp.port是否和别的服务撞了。改个端口重启即可客户端配置里的地址也要同步改。5.5 客户端连接超时先确认客户端配置的 transport 类型和 r-nacos 实际支持的协议一致。有的客户端默认走 stdio你配的是 http就连不上。另外跨机器访问时确认防火墙放行了 MCP 端口。6. 接入与后续把 MCP 能力接到你的工具链整套流程跑通后你会发现 r-nacos 这套方案的价值在于「复用」已有的 HTTP 接口不用重写注册加转发配置就能变成 MCP 服务。对于平台团队这意味着可以批量把内部服务暴露给 MCP 生态而不用每个服务单独开发 MCP Server。如果你在接入过程中需要管理调用凭证可以在 TaoToken 控制台创建 API Keys把密钥统一管起来避免散落在各个客户端配置里。创建入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节和参数说明可以对照官方文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite想先验证模型和工具调用效果可以直接在模型对话里试https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果是要长期跑编码或 Agent 场景把 MCP 工具接进日常开发流Coding Plan 会更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteAPI 基础地址统一用https://taotoken.net/api配置时别带多余路径。最后提醒一句转发规则里的inputSchema写得越清楚模型调用时越不容易传错参数这一步值得多花几分钟。