📖 目录

1. 什么是 MCP Router
2. 环境准备（nvm + Node.js 版本说明）
3. 安装 MCPR CLI
4. 查找并验证 mcpr.js
5. 配置 Codex 集成 MCP Router
6. 常见问题与排查
7. 参考资料

---

推荐claude code公益站

1. 什么是 MCP Router

MCP（Model Context Protocol） 是一种开放协议，用于在 AI 模型与外部工具、数据源之间建立交互。
MCP Router (mcpr-cli) 则是一个“代理/中转器”，作用是：

• 统一管理各种 MCP Server（如文件系统、浏览器、数据库等）。
• 提供一个入口，让 Codex / Claude Code / Cursor 等 IDE 插件只需要对接 MCP Router，而不用关心单个 MCP Server 的安装。
• 支持权限控制、Token 校验、安全沙箱等。

---

2. 环境准备（nvm + Node.js 版本说明）

由于本地使用 nvm for Windows 管理 Node.js 版本，路径和配置会与系统全局安装方式不同。

• 当前 Node.js 版本：v24.8.0

• Node 可执行文件路径：

  D:\nvm\nodejs\node.exe
  

• 全局 npm 包安装路径：

  D:\nvm\v24.8.0\node_global\
  

• mcpr-cli 安装后核心文件：

  D:\nvm\v24.8.0\node_global\node_modules\mcpr-cli\dist\mcpr.js
  

验证 Node.js 和 npm：

node -v    # v24.8.0
npm -v

---

3. 安装 MCPR CLI

通过 npm 全局安装 mcpr-cli：

npm install -g mcpr-cli@latest

安装完成后，可以运行以下命令检查是否成功：

mcpr --version

---

4. 查找并验证 mcpr.js

MCP Router 的核心脚本是 mcpr.js，在 mcpr-cli 安装路径下。

确认路径是否正确：

D:\nvm\v24.8.0\node_global\node_modules\mcpr-cli\dist\mcpr.js

手动运行测试：

node D:\nvm\v24.8.0\node_global\node_modules\mcpr-cli\dist\mcpr.js connect

如果能看到类似输出，说明安装成功：

/mcp

🔌  MCP Tools

  • Server: mcp-router
    • Command: ...
    • Tools: activate_project, ask_question, browser_navigate, ...

---

5. 配置 Codex 集成 MCP Router

Codex 会读取配置文件 .codex/config.toml，通过这个文件找到 MCP Router。

编辑配置文件（Windows 路径通常在 C:\Users\<用户名>\.codex\config.toml）：

# 配置 MCP Router 服务
[mcp_servers.mcp-router]
command = "D:\\nvm\\nodejs\\node.exe"  
args = ["D:\\nvm\\v24.8.0\\node_global\\node_modules\\mcpr-cli\\dist\\mcpr.js", "connect"]
env = { 
  SystemRoot = 'C:\\WINDOWS',
  COMSPEC = 'C:\\WINDOWS\\system32\\cmd.exe',
  MCPR_TOKEN = "mcpr_xxxxxx"  # ⚠️ 使用你在 MCP Router 获取到的 Token
}

# 配置项目路径信任
[projects.'\\?\D:\\']
trust_level = "trusted"

# 设置运行模式
sandbox_mode = "danger-full-access"  # ⚠️ 全访问模式，小心使用
approval_policy = "never"
network_access = "enabled"

key的获取地方

配置说明

• command：Node.js 的路径（由于使用 nvm，这里是 D:\nvm\nodejs\node.exe）。
• args：指向 mcpr.js 的完整路径，并带上 "connect" 参数。
• env：必须包含 MCPR_TOKEN，这是验证用的密钥（不要泄露）。
• projects：指定哪些目录是 “trusted”，MCP Router 可以操作这些目录。
• sandbox_mode：这里设为 danger-full-access，意味着不再限制读写权限。

---

6. 常见问题与排查

❌ npm error 404 Not Found - @modelcontextprotocol/cli

说明你安装的是错误包，正确的包名是：

mcpr-cli

❌ 找不到 mcpr.js

检查路径是否在：

D:\nvm\v24.8.0\node_global\node_modules\mcpr-cli\dist\mcpr.js

❌ Codex 读取不到 MCP Router

• 检查 .codex/config.toml 是否配置正确。

• 确认 Codex 插件版本支持 MCP。

• 尝试在命令行运行：

  node D:\nvm\v24.8.0\node_global\node_modules\mcpr-cli\dist\mcpr.js connect
  

  看是否能打印出 /mcp 的工具清单。

---

7. 参考资料

• MCP 官方文档
• mcpr-cli GitHub 仓库
• Linux.do - MCP Router 教程