mcpm.sh

环境要求

• 类 Unix 终端环境（安装命令与虚拟环境激活命令基于 bash）
• 已安装 curl，用于执行官方一键安装脚本
• 若走源码开发模式，需要安装 uv 和 Python 环境
• 源码开发模式需要 git 用于克隆仓库

安装与启动步骤

1. 1一键安装 MCPM

   README 推荐方式，用官方脚本安装。脚本通过 curl 管道执行，执行前可先自行查看脚本内容。

   curl -sSL https://mcpm.sh/install | bash

   复制

2. 2克隆源码

   仅在开发模式或想读源码时需要。克隆后进入仓库目录再执行后续命令。

   git clone https://github.com/pathintegral-institute/mcpm.sh.git
   cd mcpm.sh

   复制

3. 3创建虚拟环境

   开发模式第 2 步，用 uv 创建带 seed 的虚拟环境，避免污染系统 Python。

   uv venv --seed

   复制

4. 4激活虚拟环境

   开发模式第 2 步。Unix/Mac 使用 source 激活；Windows 激活方式不同，需自行适配。

   source .venv/bin/activate

   复制

5. 5安装依赖

   开发模式第 3 步，以可编辑模式安装项目，使本地改动立即生效。

   uv pip install -e .

   复制

6. 6验证 CLI 可用

   开发模式第 4 步。既可用已安装的包，也可用仓库内的开发脚本运行。

   mcpm --help

   复制

7. 7搜索并安装服务器

   从 MCP Registry 搜索可用服务器，找到后安装到全局配置，供各 MCP 客户端复用。

   mcpm search

   复制

如何确认成功

运行 mcpm doctor 检查系统健康与服务器状态；或运行 mcpm --help 能看到命令帮助，说明安装成功。

常见问题

注意事项

• README 提到还支持 brew、pipx、uv 等其他安装方式，但未给出对应命令，需查阅官方文档。
• source .venv/bin/activate 仅适用于 Unix/Mac，Windows 需使用其他激活方式。
• 示例中的 SERVER_NAME、QUERY 均为占位符，实际执行时需替换为真实名称。
• 该工具主要面向 MCP 生态，用全局配置 + Profile 的方式管理服务器，接入不同客户端时无需逐个手改 JSON。