/ 目录 / 演练场 / mcp-router
● 社区 mcp-router ⚡ 即开即用

mcp-router

作者 mcp-router · mcp-router/mcp-router

一个桌面应用,在一个地方集中管理你的所有 MCP 服务器——按工作区开关工具、记录每个调用、保持凭据本地。

MCP Router 是面向 Windows 和 macOS 的桌面管理应用(不是 MCP 服务器本身)。它汇聚你的所有 MCP 服务器,让你按项目为单位开关工具、记录每个请求用于审计、配置保持本地。当你管理 10+ 个 MCP 且需要工作区级别的控制时特别有用。

为什么要用

核心特性

实时演示

实际使用效果

router.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "router",
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "router": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-router"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add router -- npx -y mcp-router

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: mcp-router

如何管理 10+ 个 MCP 服务器而不混乱

👤 已经积累了多个 MCP 服务器的用户 ⏱ ~20 min beginner

何时使用: 你的 claude_desktop_config.json 长得要命,你不清楚哪些服务器实际被用到。

前置条件
  • 已安装 MCP Router — 从 github.com/mcp-router/mcp-router/releases 下载
步骤
  1. 导入现有配置
    打开 MCP Router → Import → 指向 Claude Desktop 的配置✓ 已复制
    → 所有服务器及其状态都列出来了
  2. 按项目创建工作区
    创建工作区 'Client-Acme' 并仅启用 GitHub + Sentry + Linear✓ 已复制
    → 该项目的最小化工具集
  3. 切换项目时切换工作区
    在 MCP Router 中切换活跃工作区。重启 Claude。✓ 已复制
    → Claude 只看到已启用的 MCP

结果: 每个项目有干净的工具界面——减少模型的上下文污染。

注意事项
  • Claude 在会话开始时缓存工具列表 — 切换工作区后始终重启客户端

审计你的代理实际使用哪些 MCP 工具

👤 任何优化设置的人 ⏱ ~15 min beginner

何时使用: 你想知道是否一半的 MCP 都没被调用过——砍掉没用的。

步骤
  1. 让它记录一周
    在 MCP Router 中启用请求日志 → 正常使用 Claude 7 天✓ 已复制
    → 日志积累了真实的使用情况
  2. 查看分析
    打开 MCP Router → Analytics。哪些服务器被调用少于 5 次?按调用次数排序。✓ 已复制
    → 明显的头部/尾部分割
  3. 禁用或卸载尾部服务器
    对于底部 25% 的服务器,禁用或完全移除✓ 已复制
    → 更精简的设置

结果: 数据驱动的 MCP 精简——更快的启动,更少的工具选择混乱。

仅在明确启用时才能使用危险的 MCP 工具

👤 注重安全的用户 ⏱ ~10 min intermediate

何时使用: 你有一个具有写权限的 GitHub MCP,但只想在你主动修复代码时启用它。

步骤
  1. 默认禁用写工具
    在 MCP Router 中,禁用 GitHub 服务器的 create_issuecreate_pull_requestdelete_repo。保持读取启用。✓ 已复制
    → 只有读工具向 Claude 公开
  2. 需要时短暂启用
    即将提交 PR——启用 create_pull_request,运行流程,再禁用✓ 已复制
    → 短的启用窗口;审计日志捕获了调用

结果: 对破坏性操作默认拒绝。

搭配使用: mcptools

组合

与其他 MCP 搭配,撬动十倍杠杆

router + mcptools

MCP Router 用于日常使用,mcptools (guard) 用于脚本化 CI 门控

在开发机上用 MCP Router 禁用 github 写操作;在 CI 中使用 mcp guard 策略文件。✓ 已复制
router + copilot

使用 copilot-mcp 发现新 MCP,用 MCP Router 集中管理它们

通过 copilot-mcp 安装 3 个新 MCP,然后在 MCP Router 中将它们组织到 'Research' 工作区。✓ 已复制

成本与限制

运行它的成本

API 配额
N/A——桌面应用
每次调用 Token 数
N/A
费用
免费,开源
提示
积极使用工作区——每个工作区只保留你需要的工具,减少每个会话的 token 开销

安全

权限、密钥、影响范围

凭据存储: 凭据本地保存在 MCP Router 的设置中,从不传输
数据出站: 路由器本身不产生数据流出;下游 MCP 的数据按常规方式处理

故障排查

常见错误与修复

Claude 仍然看到禁用的工具

Claude 在会话开始时缓存——完全退出并重新启动(不只是重新加载)

验证: Ask Claude to list its available tools
大配置导入失败

格式错误的 JSON 通常是罪魁祸首。先用 jq . claude_desktop_config.json 验证配置

服务器无法从路由器启动

路由器使用与 Claude 相同的命令——在终端中手动运行以查看真实错误

替代方案

mcp-router 对比其他方案

替代方案何时用它替代权衡
copilot-mcp (VSCode)你主要在 VSCode 中工作且倾向于使用扩展与 VSCode 绑定
手动编辑配置你总共只有 1-3 个 MCP没有日志、没有工作区切换

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills