R2AI MCP 插件

基于 R2AIBridge 的 MCP（Model Context Protocol）插件，通过 R2AIBridge 的 HTTP API 动态获取工具列表并将工具调用转发到 Android 端。

功能

• 动态工具列表：启动时或客户端请求时从 R2AIBridge 的 tools/list 获取当前可用工具，无需在代码中写死
• 透明转发：客户端调用 tools/call 时，本服务将请求转发到 R2AIBridge 的 /mcp 端点
• 配置驱动：R2AIBridge 的 base URL、超时等均在 config.json 中配置

配置

在项目根目录修改 .env，也可通过环境变量指定配置：

R2AI_BASEURL=http://127.0.0.1:5050
R2AI_TIMEOUT=30000

安装与运行

npm install r2ai-mcp

在 客户端 中配置

在客户端的 MCP 配置（例如 mcp.json）中添加：

{
  "mcpServers": {
    "r2ai": {
      "command": "npx",
      "args": ["@hujiayucc/r2ai-mcp"],
      "env": {
        "R2AI_BASEURL": "http://127.0.0.1:5050",
        "R2AI_TIMEOUT": 30000
      }
    }
  }
}

依赖

• Node.js >= 18
• 已启动的 R2AIBridge 服务（Android 设备上运行 R2AIBridge 应用并点击「启动服务」）

协议说明

• 本服务实现 MCP 的 stdio 传输，与 R2AIBridge 的 HTTP JSON-RPC 2.0 接口对接
• 工具列表来自 R2AIBridge POST {url}/mcp、method: "tools/list"
• 工具调用为 method: "tools/call"，params: { name, arguments }

License

MIT License

Copyright (C) 2026 hujiayucc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.