mcp 统一管理器-mcpHub使用笔记
- 内容介绍
- 文章标签
- 相关推荐
写作缘由：mcp 管理软件求推
说明：非项目推广，只是记录使用方法，避免踩坑
使用的是： mcphub
特点：
-
支持docker/npm安装，因此支持windows+linux
-
支持统一管理MCP（开启/关闭等）
-
支持MCP Router
缺点：
-
需要下载1G多的文件/镜像，因此对网络要求较高
-
按照教程并不能顺利将其配置给关于AI客户端使用，确实如何配置密钥相关内容（因此新手会不知如何使用，比如我）。
安装实操环境
Ubuntu 22.04
安装
这里使用的是npm安装（全局安装）。社区推荐的是Docker安装，但是我觉得npm安装之后可以直接运行mcpHub命令，更方便。
安装前请确保已经安装了nodejs和npm。
# 全局安装
npm install -g @samanhappy/mcphub
# 运行 MCPHub
mcphub
# 以另外的端口运行
# 十分不推荐,因为其他的功能还是在3000端口，会引起问题
# 暂时没有深究
PORT 9000 mcpHub
配置
访问控制面板：http://localhost:3000
默认用户名：admin
默认密码：admin123
建议登录后立马修改密码
界面类似：（工具默认会有4个MCP server，我已经把它们都删了然后装了自己要的）
image1605×707 72.5 KB
添加MCP server
点击“服务器” → “导入”，以json格式导入MCP，支持批量导入。
image-11596×483 64.4 KB
可在此批量管理mcp 服务器。
还可点击“服务器” → “分组”，创建mcp分组
生成密钥 （重要）
点击左下角“admin” （下面有“修改密码”的页面）-> “密钥” → 创建密钥
image-31587×959 57 KB
接入AI客户端
设置环境变量
临时设置：仅在当前终端生效
export BEARER_TOKEN=XXX
永久设置：
在 ~/.bashrc写入密钥的环境变量：
export BEARER_TOKEN=XXX
写入保存后加载生效：
source ~/.bashrc
接入AI客户端
我通过 CC Switch统一管理多个AI客户端的mcp,这里是导入CC Switch的参考配置：名称就是mcpHub
{
"headers": {
"Authorization": "Bearer $BEARER_TOKEN"
},
"note": "mcps from mcpHub",
"type": "streamable-http",
"url": "http://localhost:3000/mcp"
}
注意
一定要配置headers内的密钥，否则无法正常使用
AI客户端登录登录授权
首次运行时需要登录授权:
codex mcp login mcpHub
运行后会提示打开一个链接继续授权，授权后即可正常使用。
此时重新进入codex,运行"/mcp"，会显示mcpHub内所有启用的mcp的所有可用方法：
image-4756×498 43 KB
网友解答：--【壹】--： Vonius:
我通过 CC Switch统一管理
佬你真用过cc-switch吗， 它好像不支持 “type”: "streamable-http"吧
--【贰】--：
mcp router似乎不支持linux，我需要跨linux+windows使用的，mcphub挺合我心意的
--【叁】--：
这个怎么在openclaw中引入
--【肆】--：
佬用过 mcp router 或者 1mcp 吗? 和这两个比较, mcpHub 如何?
--【伍】--：
这必须mark一下，解决了我想解决好久的难题！感谢分享
--【陆】--：
感谢大佬
--【柒】--：
你现在升级不会丢数据吗，我之前全局安装升级的时候会丢mcp和设置数据，翻代码看了一下，设置MCP_SETTINGS_PATH 环境变量可以把数据存到别的地方，比如我就放到了~/.mcphub/mcp_settings.json
--【捌】--：
感谢分享
--【玖】--：
噢我下载的源码然后源码运行，可以不更新。
--【拾】--：
佬你说的是给谁设置这个变量啊，不太清楚你的意思
--【拾壹】--：
部队，我确实是npm装的，确实需要设置这个参数，感谢大佬
--【拾贰】--：
可以设置下 MCP_SETTINGS_PATH 环境变量，保存下设置，不然更新或者重装数据就没了
--【拾叁】--：
给codex用没问题，给claude不行，要自己调一下
写作缘由：mcp 管理软件求推
说明：非项目推广，只是记录使用方法，避免踩坑
使用的是： mcphub
特点：
-
支持docker/npm安装，因此支持windows+linux
-
支持统一管理MCP（开启/关闭等）
-
支持MCP Router
缺点：
-
需要下载1G多的文件/镜像，因此对网络要求较高
-
按照教程并不能顺利将其配置给关于AI客户端使用，确实如何配置密钥相关内容（因此新手会不知如何使用，比如我）。
安装实操环境
Ubuntu 22.04
安装
这里使用的是npm安装（全局安装）。社区推荐的是Docker安装，但是我觉得npm安装之后可以直接运行mcpHub命令，更方便。
安装前请确保已经安装了nodejs和npm。
# 全局安装
npm install -g @samanhappy/mcphub
# 运行 MCPHub
mcphub
# 以另外的端口运行
# 十分不推荐,因为其他的功能还是在3000端口，会引起问题
# 暂时没有深究
PORT 9000 mcpHub
配置
访问控制面板：http://localhost:3000
默认用户名：admin
默认密码：admin123
建议登录后立马修改密码
界面类似：（工具默认会有4个MCP server，我已经把它们都删了然后装了自己要的）
image1605×707 72.5 KB
添加MCP server
点击“服务器” → “导入”，以json格式导入MCP，支持批量导入。
image-11596×483 64.4 KB
可在此批量管理mcp 服务器。
还可点击“服务器” → “分组”，创建mcp分组
生成密钥 （重要）
点击左下角“admin” （下面有“修改密码”的页面）-> “密钥” → 创建密钥
image-31587×959 57 KB
接入AI客户端
设置环境变量
临时设置：仅在当前终端生效
export BEARER_TOKEN=XXX
永久设置：
在 ~/.bashrc写入密钥的环境变量：
export BEARER_TOKEN=XXX
写入保存后加载生效：
source ~/.bashrc
接入AI客户端
我通过 CC Switch统一管理多个AI客户端的mcp,这里是导入CC Switch的参考配置：名称就是mcpHub
{
"headers": {
"Authorization": "Bearer $BEARER_TOKEN"
},
"note": "mcps from mcpHub",
"type": "streamable-http",
"url": "http://localhost:3000/mcp"
}
注意
一定要配置headers内的密钥，否则无法正常使用
AI客户端登录登录授权
首次运行时需要登录授权:
codex mcp login mcpHub
运行后会提示打开一个链接继续授权，授权后即可正常使用。
此时重新进入codex,运行"/mcp"，会显示mcpHub内所有启用的mcp的所有可用方法：
image-4756×498 43 KB
网友解答：--【壹】--： Vonius:
我通过 CC Switch统一管理
佬你真用过cc-switch吗， 它好像不支持 “type”: "streamable-http"吧
--【贰】--：
mcp router似乎不支持linux，我需要跨linux+windows使用的，mcphub挺合我心意的
--【叁】--：
这个怎么在openclaw中引入
--【肆】--：
佬用过 mcp router 或者 1mcp 吗? 和这两个比较, mcpHub 如何?
--【伍】--：
这必须mark一下，解决了我想解决好久的难题！感谢分享
--【陆】--：
感谢大佬
--【柒】--：
你现在升级不会丢数据吗，我之前全局安装升级的时候会丢mcp和设置数据，翻代码看了一下，设置MCP_SETTINGS_PATH 环境变量可以把数据存到别的地方，比如我就放到了~/.mcphub/mcp_settings.json
--【捌】--：
感谢分享
--【玖】--：
噢我下载的源码然后源码运行，可以不更新。
--【拾】--：
佬你说的是给谁设置这个变量啊，不太清楚你的意思
--【拾壹】--：
部队，我确实是npm装的，确实需要设置这个参数，感谢大佬
--【拾贰】--：
可以设置下 MCP_SETTINGS_PATH 环境变量，保存下设置，不然更新或者重装数据就没了
--【拾叁】--：
给codex用没问题，给claude不行，要自己调一下