还在为MCP管理烦恼吗?这款一站式管理工具能帮你轻松搞定所有客户端的安装与配置,从此告别繁琐的重复操作!
为了让你快速上手,本文将围绕以下三个核心内容展开:
- 1. MCP工具带来的便利与当前管理痛点
- 2. mcp-router的核心功能与优势解析
- 3. 安装指南与快速上手配置方法

一、MCP的“爱”与“恨”
提到MCP,很多用户真是又爱又恨。
爱它,是因为MCP的出现大幅降低了大模型在本地调用tools的门槛。在此之前,普通用户的本地大模型应用场景基本只限于“我问你答”。想给大模型添加工具,要么借助 dify/Coze 编写复杂工具,要么自己写代码处理大模型请求。
恨它,则是因为尽管MCP统一了协议,但各个客户端却缺乏统一的规范。无论你查看哪个MCP或三方导航的安装说明页面,都会列出至少三种客户端的安装教程,我随便截个图给大家看看。
官方文档通常还好,至少认真写了各客户端的安装说明。但一些三方导航网站的介绍往往不够详细,对非专业玩家来说,使用起来仍有门槛。
除了安装麻烦,管理和维护更是让人头疼。
- 管理混乱:即使像 CherryStudio 这样有界面的软件,内置的MCP列表也让人眼花缭乱,不知所措,除了内置的,我根本不想点开。
- 配置复杂:更别说像 ClaudeCode 和 Codex 这类CLI工具了,所有配置都要通过 Json 和 toml 这类结构化格式编写,而且还要区分用户级和项目级,不同工具间的配置还不通用。
- 迁移困难:换一个新客户端,或者换一台电脑,所有MCP都得重新配置一遍,太折腾了!
我真正开始频繁使用MCP,是在6月份高频使用 ClaudeCode 之后,而且用下来也就那么几个常用工具。此外像 CherryStudio、Gemini cli 这些虽支持MCP,我也没去配置。原因很简单:麻烦!安装麻烦,管理麻烦,迁移更麻烦,能不弄就懒得弄!
直到前段时间用上 Codex,才不得不面对重新配置的问题!手写?那是不可能的,连让AI写我都懒得指挥!
然后我就发现了一个MCP一键管理的神器——mcp-router,从那时起,我才真正喜欢上用MCP。
二、用mcp-router,把所有MCP服务管起来
顾名思义,mcp-router 是一个本地的MCP路由工具。它的核心功能很简单:
- 集中接入:将所有MCP服务器接入进来,无论远程还是本地。
- 多种配置:支持常见的配置方式,如 DXT、JSON、手动配置、远程源,均可。
- 统一开关:提供统一的管理面板,想开就开,想关就关。
- 单点接入:为不同客户端生成一个本地接入凭据,各客户端只需连接这一个入口。
- 可观测性:所有请求日志统一查看,包括功耗、延迟、错误码,一目了然。
- 数据本地化与迁移:所有数据存储在本机,配置可导出导入,迁移不再是噩梦。
简单来说,就是用 mcp-router 把MCP管理从多入口改为单入口,从分散配置改为集中配置,从黑盒运行变为可观察。
下面这张图是我本地正在使用的界面。无论哪个客户端,都在这里统一管理,需要用的工具打开开关即可,其他什么都不用管。
小提示:如果你的MCP服务器很多,建议养成给每个MCP标注备注和使用场景的习惯,这样在切换不同客户端时,可以快速筛选出需要的工具集。
三、安装和快速上手配置
官方Github地址:
https://github.com/mcp-router/mcp-router
根据你的操作系统下载对应的客户端即可。下面我们以 macOS 为例进行演示。
Step 1 : 添加MCP服务
mcp-router 支持 4种不同的方式 添加MCP,不过常用的主要是 JSON 和 Remote。下面以 SequentialThinking 为例演示。
我们可以在SequentialThinking官方Github上找到JSON格式的安装说明,直接复制 npx 的配置格式粘贴到mcp-router中,点击 import 按钮即可。
如果一切顺利,直接就能安装成功。回到MCP Servers页面,刷新列表就能看到刚才添加的MCP,不过默认是关闭的,使用时需要手动打开开关。
小提示:添加MCP时,请确保你的电脑已安装 Node.js 和 npm,因为很多MCP服务器需要通过 npx 运行。你可以打开终端,输入
node -v和npm -v检查是否已安装。
Step 2: 集成到客户端
无论是 Cursor,Cline,windsurf,Claude code,Codex 还是 cherryStudio...
通通只需要设置一次!
在 MCP App Integrations 页面,默认支持 5个客户端。对于默认支持的客户端,比如我本地已安装的 Cursor 和 VSCode,只需点击【Add MCP Config】按钮即可一键集成。
已经集成的,也能通过【Access Control】控制在当前App内可用的MCP。
此时回到 Cursor,在MCP配置中会看到自动添加了一个名为 mcp-router 的MCP服务,我们所有的可用tools都集中在这个MCP下面。是不是超级简单?
小提示:如果你的客户端不在默认支持列表里,请参考 Step 3 进行自定义添加。你可以在“App Integration”页面的搜索框中尝试搜索,看是否已被后续版本支持。
Step 3:添加自定义客户端
Cherry Studio 和 Codex 这类不是默认支持的客户端,需要通过自定义方式添加。
添加 Cherry Studio
首先安装一个工具:
npm install -g mcpr-cli@latest
然后输入一个 App name 即可添加成功。
接下来,点击【How to use】,在弹出的窗口中直接复制JSON格式的配置信息,粘贴到 Cherry Studio 中即可。
添加 Codex
至于 Codex,会稍微复杂一些。你需要在访达中前往以下路径:
## 请将 /Users/baisu 替换为你的用户名
/Users/[user name]/.codex
然后用编辑软件打开 config.toml,把MCP相关的配置全部删除,加上这段内容:
[mcp_servers.mcp-router]
command = "npx"
args = ["-y", "mcpr-cli@latest", "connect"]
env = { MCPR_TOKEN = "mcpr_这里是你的 token" }
保存后,重新进入 codex,能看到 mcp-router 这个mcp就表示成功了。
小提示:编辑 config.toml 文件前,建议先备份原始文件,以防配置出错后可以快速恢复。另外,`MCPR_TOKEN` 中的“这里是你的 token”记得替换成你在 mcp-router 中生成的真实Token。
常见问题与解答
-
Q:我安装了mcp-router,但添加MCP服务时提示安装失败,怎么办?
A:请先检查你的网络连接是否正常。如果网络没问题,再确认一下你是否已安装Node.js和npm。如果这两个都没问题,尝试运行npm cache clean --force清除npm缓存,然后重新添加。如果问题依旧,可以查看mcp-router的日志(一般在界面的“设置”或“日志”板块中)来定位具体错误信息。 -
Q:我集成了mcp-router到Codex后,在Codex里看不到mcp-router,怎么办?
A:首先确认 config.toml 文件的路径是否正确(应该是~/.codex/config.toml)。然后检查文件内容,确保 mcp_servers.mcp-router 配置块的代码格式正确(尤其是方括号和逗号)。最后,保存文件后需要完全关闭并重新打开Codex,之前打开的会话中新配置不会生效。 -
Q:如果我想迁移我的mcp-router配置到新电脑,该怎么做?
A:在旧电脑的mcp-router界面中,找到“设置”或“导出”功能,将配置导出为一个JSON文件。将这个文件复制到新电脑,然后在mcp-router中使用“导入”功能,选择该文件即可。建议导出前,先关闭不需要的MCP服务,以加快导入速度。不同大版本间的导入可能有兼容性问题,请确保新电脑上安装的mcp-router版本与旧电脑上的版本一致或更高。 -
Q:mcp-router支持哪些操作系统?
A:mcp-router是一款跨平台工具,目前支持 macOS、Windows 和 Linux。你可以从官方Github仓库的 Releases 页面下载对应系统的安装包。macOS和Linux用户通常使用.dmg或.AppImage格式,Windows用户使用.exe或.msi格式。
希望这篇教程能帮助你轻松上手mcp-router,彻底告别MCP管理的烦恼!
