/ 目錄 / 演練場 / mcp-router
● 社群 mcp-router ⚡ 即開即用

mcp-router

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

桌面應用程式,集中管理所有 MCP 伺服器 — 按工作區切換工具開關、記錄每次呼叫、認證資訊保留在本機

MCP Router 是一個桌面管理應用程式(不是 MCP 伺服器本身),支援 Windows 和 macOS。它整合所有的 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 → 匯入 → 指向 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 → 分析。哪些伺服器被呼叫少於 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 配額
不適用 — 桌面應用程式
每次呼叫 Token 數
不適用
費用
免費,開源
提示
積極使用工作區 — 每個工作區只保留你需要的工具,減少每個工作階段的 token 開銷

安全

權限、密鑰、影響範圍

憑證儲存: 認證資訊儲存在本機的 MCP Router 設定中;不會被傳輸
資料出站: 路由器本身不會外洩資料;下游 MCP 的資料如常流動

故障排查

常見錯誤與修復

Claude 仍然看到停用的工具

Claude 在工作階段開始時快取 — 完全退出並重新啟動(不只是重新載入)

驗證: 詢問 Claude 列出其可用的工具
大型設定的匯入失敗

格式不正確的 JSON 是常見原因。先使用 jq . claude_desktop_config.json 驗證設定

伺服器無法從路由器啟動

路由器使用與 Claude 相同的命令 — 在終端機中手動執行它以查看真正的錯誤

替代方案

mcp-router 對比其他方案

替代方案何時用它替代權衡
copilot-mcp (VSCode)你住在 VSCode 中並偏好擴充功能受限於 VSCode
手動編輯設定你總共有 1-3 個 MCP沒有記錄,沒有工作區切換

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills