mcp-router/mcp-router · 上手攻略

  • 仓库：mcp-router/mcp-router
  • 链接：https://github.com/mcp-router/mcp-router
  • 分类：agent / llm-infra（Model Context Protocol 服务器管理桌面端）
  • 作者：spark
  • 更新：2026-07-26

一、是什么

MCP Router 是一个桌面端（Desktop）的 MCP 服务器统一管理应用，自定位为 "Unified MCP Server Management App / MCP Manager"。Model Context Protocol（MCP）是 Anthropic 推出的"让 LLM 调用外部工具/数据源"的开放协议，过去一年 MCP 服务器数量爆炸——GitHub、文件系统、数据库、浏览器、Slack……每个 MCP 服务器都自己一套配置、连接方式和开关。

MCP Router 把这些散点收拢进一个桌面端 dashboard：

  • 统一连接：本地 / 远程 MCP 服务器都收在一个界面，支持 DXT、JSON、手动三种接入方式；
  • 分组与隔离：用 Projects 把"工作上下文"分组，用 Workspaces（类浏览器 profile）切换不同场景；
  • 细粒度开关：每台服务器、每个工具都能单独 on/off；
  • 多客户端：从同一台 MCP Router 给 Claude、Cline、Windsurf、Cursor 或自建客户端接出；
  • 可观测：请求日志、统计图内置；
  • 隐私：所有配置、日志、凭据都在本地，桌面端源码公开可审。

主语言 TypeScript，仓库 Stars ~2.1k，最近提交 2026-06-27（更新节奏稍缓于一线热门 MCP 客户端，但功能定位不同）。许可证是 Sustainable Use License（非标准 OSI 许可，详见下文）。

二、解决什么问题

MCP 生态当前的最大痛点是"散"：

  • 你装了 10 个 MCP 服务器，每个都有自己的 mcpServers JSON 段，散在不同客户端配置文件里；
  • 想"在某个项目只启用文件+GitHub MCP，其他项目用浏览器+Slack MCP"——大多数客户端只支持全局开关；
  • 想临时禁用某个工具（比如 bash）做安全审计？只能改配置或卸载；
  • 想看 LLM 实际调用了哪些 MCP 工具、调用频率——客户端侧日志残缺。

MCP Router 对位：

  • 统一面板：所有 MCP 服务器在一个 dashboard；
  • 项目化：Projects / Workspaces 把"按场景切 MCP 集合"做成一级公民；
  • 逐工具开关：不只是开关服务器，还能关掉某个危险工具；
  • 请求日志 & 统计：内嵌可观测性；
  • 跨客户端：同一台 MCP Router 可同时给 Claude / Cursor / Cline / Windsurf 提供 MCP 服务；
  • 本地优先：凭据、日志不上云，桌面端源码可审计。

适合：日常重度使用 MCP 的 LLM 重度玩家、用多个 AI 客户端的工作流、要给团队搭"标准化 MCP 集合"的基础设施同学。

三、快速安装

MCP Router 是桌面端应用，不是 CLI 也不是 npm 包本体。

  1. 打开 https://github.com/mcp-router/mcp-router/releases ；
  2. 下载对应平台安装包： - Windows：.exe 安装器或便携包； - macOS：.dmg（含 Apple Silicon / Intel 版本，看 README 当前 release notes）；
  3. 启动 MCP Router，第一次进会引导生成一个 MCPR Token（形如 mcpr_xxx），这是后续 CLI 接入的凭证。

⚠️ 当前没有 Linux 官方桌面包——Linux 用户需要自行评估（Electron 应用通常可跑，但官方未在 README 列 Linux 支持）。

四、核心用法

4.1 添加 MCP 服务器

三种方式：

  • DXT 导入：如果对方 MCP 服务器打包成 Anthropic DXT，直接拖进 MCP Router；
  • JSON 导入：粘贴一段标准的 mcpServers JSON；
  • 手动添加：填写名称、命令/参数、URL（远程）、环境变量等。

接好后会出现在服务器列表，dashboard 上能直接 ping / 启停。

4.2 项目（Projects）与工作区（Workspaces）

  • Project：一组 MCP 服务器 + 配置，类"工作上下文"——比如"前端项目组"启用 filesystem + github + playwright，"数据科学组"启用 sqlite + jupyter + s3。
  • Workspace：类似浏览器 profile，可整套切换默认 MCP 集合，适合"工作账号 / 个人账号 / 演示账号"并存。

CLI 接入时按项目拉取：

npx -y @mcp_router/cli connect --project <project-name>

4.3 工具级开关

在 MCP Router 里点开某台服务器，能看到该服务器暴露的所有 tool（如 filesystem.read_file / bash.exec）。可以按 tool 临时禁用——对做 prompt injection 演练或限制 Agent 权限特别有用。

4.4 接出到 AI 客户端

MCP Router 同时被设计成"中间层"。从 Claude / Cline / Windsurf / Cursor 那一侧连进来，路径通常是：

  1. 在 MCP Router 里创建一个 Custom App，拿到 MCPR_TOKEN（前缀 mcpr_）；
  2. 在客户端的 MCP 配置里把 MCP Router 的本地 HTTP endpoint（默认 http://localhost: 某个端口，具体看应用内提示）填进去，配 token；
  3. 客户端能列出 MCP Router 里所有已启用工具。

4.5 CLI 独立用法

官方 CLI 包 @mcp_router/cli（公开仓库 mcp-router/mcpr-cli，README 标注"开发已迁移"）。典型用法：

# 1. 先启动桌面端 MCP Router，并在应用里生成 token

# 2. 设 token 到环境
export MCPR_TOKEN="mcpr_your_token"

# 3. 在当前项目里把所有已启用 MCP 工具"挂"进当前会话
npx -y @mcp_router/cli connect

# 4. 指定某个项目
npx -y @mcp_router/cli connect --project <project-name>

⚠️ CLI 当前在维护模式（迁移公告），生产使用请以桌面端 README 当前说明为准。

4.6 日志与统计

应用内 "Stats" / "Logs" 面板能看到：每个 MCP 工具被调用次数、最近错误、延迟分布。这对排查 MCP 集成的常见问题（连接失败、tool schema 变更）非常直接。

五、典型适用场景

  • 多 MCP 重度用户：同时接 5+ MCP 服务器，希望按项目分组的；
  • 多 AI 客户端切换：同时用 Claude Desktop + Cursor + Cline，希望 MCP 配置只维护一份；
  • Agent 安全演练：要给某个项目临时禁掉 bash/write 工具，做最小权限实验；
  • 团队 MCP 模板：在 MCP Router 里把"团队默认 MCP 集合"导出 JSON，新人导入即可；
  • MCP 调试：客户端侧看不到 MCP 细节，Router 内置日志能直接定位 tool 失败原因。

六、坑与注意

  1. 许可证不是标准 OSI：项目用 Sustainable Use License，条款上对"商业产品中转售/打包"有限制；公司级使用前请先读 LICENSE.md，必要时找法务确认是否影响分发。
  2. 桌面端，没 Linux 官方包：仓库主走 Windows / macOS。Linux 用户要么等要么自己跑（应用是 Electron 类）。
  3. 最近一次提交 2026-06-27：相对一线 MCP 客户端（如 Cursor）迭代节奏稍缓；适合"管理面板"用法，不适合把它当成"主客户端"替代。
  4. CLI 仓库（mcp-router/mcpr-cli）已挂"开发已迁移"：CLI 用法要看桌面端 README 当前状态，不要假定 CLI 会持续发版。
  5. 依赖桌面应用常驻：CLI 是"客户端"，MCP Router 桌面端必须运行；做无界面服务器端 MCP 路由不是它的设计目标（那种需求看 MCP 网关类项目）。
  6. MCPR_TOKEN 是本地凭证：mcpr_xxx token 用于本地 loopback 鉴权；不要把它公开、不要贴 issue、不要进 git。
  7. 项目 / 工作区 ≠ 多租户：MCP Router 是单机管理工具，不解决"团队统一配置 + 权限 + 审计"——要做企业级 MCP 网关得另寻方案。
  8. MCP 协议本身还在演进：tool schema、resource 概念、auth 都在变，跟一个较新的桌面端要预留"协议升级时跟进"的预期。

七、与同类对比

工具 形态 关键差异
MCP Router 桌面端 dashboard + 可选 CLI 统一管理、本地优先、项目/工作区分组、跨客户端接出
直接配 mcpServers JSON（Claude/Cursor/Cline 原生） 客户端自带 零依赖但每客户端一份配置，无统一管理
mcp-cli（@mcp/cli） 纯 CLI 命令行友好，但不带 dashboard / 项目管理
MCP Anywhere / Locomotive Router MCP 网关式（web） 多租户服务端网关，定位"团队共享 MCP"，比 MCP Router 重
Smithery / Glama 等 MCP 目录 目录 + 安装 解决"找 MCP"，不解决"管理多个 MCP"
自建 Docker Compose 拼 MCP 通用 最灵活，但每加一个 MCP 都得自己写 compose / 配置

八、一句话推荐

如果你同时用 2+ 个 AI 客户端、又装了 3+ 个 MCP 服务器，MCP Router 是当下少有的"本地优先、统一面板、项目分组、跨客户端接出"的桌面端方案，值得装上做 PoC；但许可证非标准、CLI 维护中、企业级多租户还得另寻网关。 单一客户端单 MCP 用户暂时不需要。