
mcpm.sh
一条命令搜索、安装并配置 MCP 服务器,多客户端通吃
mcpm.sh 是一个面向 MCP(Model Context Protocol)生态的跨平台命令行包管理器与注册中心。随着 Claude Desktop、Cursor、Cline、Goose 等客户端纷纷支持 MCP,用户需要为每个客户端手动编辑 JSON 配置、管理服务器路径和参数,过程繁琐且容易出错。mcpm.sh 把 MCP 服务器当作软件包来管理,提供搜索、安装、配置一体化流程,一条命令即可把服务器接入不同客户端。它还内置 Router 与 Profile 能力:Router 可在多个 MCP 服务器之间做请求路由与聚合,Profile 允许按场景保存不同的服务器组合,一键切换工作环境。项目用 Python 编写,支持 stdio 与 SSE 两种传输方式,兼容 macOS、Linux、Windows,并可通过 pip、Homebrew 等渠道安装。
项目数据
使用教程
环境要求
- 类 Unix 终端环境(安装命令与虚拟环境激活命令基于 bash)
- 已安装 curl,用于执行官方一键安装脚本
- 若走源码开发模式,需要安装 uv 和 Python 环境
- 源码开发模式需要 git 用于克隆仓库
安装与启动步骤
-
1一键安装 MCPM
README 推荐方式,用官方脚本安装。脚本通过 curl 管道执行,执行前可先自行查看脚本内容。
curl -sSL https://mcpm.sh/install | bash -
2克隆源码
仅在开发模式或想读源码时需要。克隆后进入仓库目录再执行后续命令。
git clone https://github.com/pathintegral-institute/mcpm.sh.git cd mcpm.sh -
3创建虚拟环境
开发模式第 2 步,用 uv 创建带 seed 的虚拟环境,避免污染系统 Python。
uv venv --seed -
4激活虚拟环境
开发模式第 2 步。Unix/Mac 使用 source 激活;Windows 激活方式不同,需自行适配。
source .venv/bin/activate -
5安装依赖
开发模式第 3 步,以可编辑模式安装项目,使本地改动立即生效。
uv pip install -e . -
6验证 CLI 可用
开发模式第 4 步。既可用已安装的包,也可用仓库内的开发脚本运行。
mcpm --help -
7搜索并安装服务器
从 MCP Registry 搜索可用服务器,找到后安装到全局配置,供各 MCP 客户端复用。
mcpm search
如何确认成功
运行 mcpm doctor 检查系统健康与服务器状态;或运行 mcpm --help 能看到命令帮助,说明安装成功。
常见问题
Q:提示找不到 mcpm 命令怎么办?
A:先运行 mcpm doctor 检查系统健康状态;若是开发模式安装,请确认已激活虚拟环境并执行过 uv pip install -e .。
Q:如何查看某个 MCP 服务器的详细信息?
A:运行 mcpm info SERVER_NAME,把 SERVER_NAME 换成 mcpm search 结果中的真实服务器名。
Q:如何卸载已安装的 MCP 服务器?
A:运行 mcpm uninstall SERVER_NAME,把 SERVER_NAME 换成实际服务器名,即可从全局配置中移除。
Q:从 v1 升级到 v2,旧配置怎么迁移?
A:运行 mcpm migrate,README 说明该命令用于把 v1 配置迁移到 v2。
注意事项
- README 提到还支持 brew、pipx、uv 等其他安装方式,但未给出对应命令,需查阅官方文档。
- source .venv/bin/activate 仅适用于 Unix/Mac,Windows 需使用其他激活方式。
- 示例中的 SERVER_NAME、QUERY 均为占位符,实际执行时需替换为真实名称。
- 该工具主要面向 MCP 生态,用全局配置 + Profile 的方式管理服务器,接入不同客户端时无需逐个手改 JSON。
核心亮点
- 统一管理多个客户端的 MCP 配置,避免逐个手改 JSON
- 内置 Router 与 Profile,可做服务器路由和场景化组合切换
- 支持 stdio/SSE 传输及 pip、Homebrew 多平台安装方式
不足之处
- 项目处于早期,星标不足千,生态与文档仍在完善
- Router、Profile 等高级功能相对小众,实际稳定性待更多验证
适用场景
- 为 Claude Desktop、Cursor、Cline 等多个客户端批量配置 MCP 服务器
- 按项目或任务保存不同 MCP 服务器组合,一键切换 Profile
- 在多个 MCP 工具间做统一路由与聚合调用
替代项目
mcp-installer、Smithery CLI
项目介绍
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···