🌟 MCPM - Model Context Protocol Manager

English | 简体中文

Open Source. Forever Free.
Built with ❤️ by Path Integral Institute

🌟 MCPM - 模型上下文协议管理器

MCPM 是一款用于管理 MCP 服务的开源命令行工具。它提供了简化的全局配置方式：只需安装一次服务，再通过配置档案进行组织，之后即可将其集成到任何 MCP 客户端中。其功能包括通过中央注册表发现服务、直接执行、共享功能以及客户端集成工具。

演示展示的是过时的 v1 命令，新版演示正在制作中……

🤝 社区贡献

💡 壮大 MCP 生态！ 欢迎为我们的 MCP 注册表贡献力量。添加你自己的服务、完善文档或提出功能建议。开源离不开社区参与！

🚀 快速安装

推荐：

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

也可以选择其他安装方式，例如 brew、pipx、uv 等。

🔎 概览

MCPM v2.0 通过全局配置模型简化了 MCP 服务管理。主要功能包括：

• ✨ 全局服务管理：服务只需安装一次，即可随处使用
• 📋 虚拟配置档案：使用标签组织服务，适用于不同的工作流
• 🔍 服务发现：从 MCP 注册表浏览并安装服务
• 🚀 直接执行：通过 stdio 或 HTTP 运行服务进行测试
• 🌐 公开共享：通过安全隧道共享服务
• 🔄 服务更新：检查并应用基于 git、NPX 和二进制文件的服务更新
• 🎛️ 客户端集成：管理 Claude Desktop、Cursor、Windsurf 等客户端的配置
• 🤖 适用于 AI Agent：支持非交互式命令行及全面的自动化，并提供 llm.txt 指南
• 💻 美观的命令行界面：丰富的格式和交互式界面
• 📊 使用情况分析：监控服务的使用情况和性能

MCPM v2.0 以简洁的全局工作区模型取代了 v1 中复杂的基于目标的系统。

🖥️ 支持的 MCP 客户端

MCPM 将支持为以下客户端管理 MCP 服务：

• 🤖 Claude Desktop（Anthropic）
• ⌨️ Cursor
• 🏄 Windsurf
• 🧩 Vscode
• 📝 Cline
• ➡️ Continue
• 🦢 Goose
• 🔥 5ire
• 🦘 Roo Code
• 💻 OpenCode
• ✨ 更多客户端即将推出……

🔥 命令行界面（CLI）

MCPM 提供了功能全面、界面简洁有序的命令行界面。v2.0 架构采用全局配置模型，服务只需安装一次，即可通过配置档案进行组织，并按需集成到指定的 MCP 客户端中。

ℹ️ 常规

mcpm --help          # Display help information and available commands
mcpm --version       # Display the current version of MCPM

🌐 服务管理

全局服务安装和管理命令：

# 🔍 Search and Install
mcpm search [QUERY]           # Search the MCP Registry for available servers
mcpm info SERVER_NAME         # Display detailed information about a server
mcpm install SERVER_NAME      # Install a server from registry to global configuration
mcpm uninstall SERVER_NAME    # Remove a server from global configuration

# 📋 List and Inspect
mcpm ls                       # List all installed servers and their profile assignments
mcpm edit SERVER_NAME         # Edit a server configuration
mcpm inspect SERVER_NAME      # Launch MCP Inspector to test/debug a server

🚀 服务执行

直接执行服务以进行测试或集成：

mcpm run SERVER_NAME          # Execute a server directly over stdio
mcpm run SERVER_NAME --http   # Execute a server over HTTP for testing
mcpm share SERVER_NAME        # Share a server through secure tunnel for remote access
mcpm usage                    # Display comprehensive analytics and usage data

📂 配置管理

配置文件是用于将服务按逻辑分组、适配不同工作流的虚拟标签：

# 🔄 Profile Operations
mcpm profile ls               # List all profiles and their tagged servers
mcpm profile create PROFILE   # Create a new profile
mcpm profile rm PROFILE       # Remove a profile (servers remain installed)
mcpm profile edit PROFILE     # Interactive server selection for profile

# 🚀 Profile Execution
mcpm profile run PROFILE      # Execute all servers in a profile over stdio or HTTP
mcpm profile share PROFILE    # Share all servers in a profile through secure tunnel
mcpm profile inspect PROFILE  # Launch MCP Inspector for all servers in profile

🖥️ 客户端集成

管理 MCP 客户端配置（Claude Desktop、Cursor、Windsurf 等）：

mcpm client ls                 # List all supported MCP clients and their status
mcpm client edit CLIENT_NAME   # Interactive server enable/disable for a client
mcpm client edit CLIENT_NAME -e # Open client config in external editor
mcpm client import CLIENT_NAME  # Import server configurations from a client

🔄 服务更新

检查并应用已安装 MCP 服务的更新：

mcpm update                   # Update all servers
mcpm update SERVER_NAME       # Update a specific server
mcpm update --check           # Dry run — check for updates without applying
mcpm update --rebase          # Use git rebase instead of fast-forward
mcpm update --init            # Scan servers and populate source metadata
mcpm update --init --force    # Re-detect all source metadata

MCPM 会跟踪每个服务的来源（git 仓库、npm 包、HTTP 远程服务），并可自动拉取最新更改。默认情况下，基于 Git 的服务通过 git pull --ff-only 更新，也可以选择使用 --rebase。NPX/UVX 服务会在运行时自动更新，并仅供参考。

🛠️ 系统与配置

mcpm doctor                   # Check system health and server status
mcpm config                   # Manage MCPM configuration and settings
mcpm migrate                  # Migrate from v1 to v2 configuration

📚 注册表

MCP 注册表是可用 MCP 服务的中央仓库，可通过 MCPM 安装。注册表地址：mcpm.sh/registry。

🤖 AI Agent 集成

MCPM 专为 AI Agent 友好性而设计，并提供全面的自动化支持。每个交互式命令都有使用 CLI 参数和环境变量的非交互式替代方式。

🔧 非交互模式

设置环境变量以实现全面自动化：

export MCPM_NON_INTERACTIVE=true  # Disable all interactive prompts
export MCPM_FORCE=true            # Skip confirmations
export MCPM_JSON_OUTPUT=true      # JSON output for parsing

📋 LLM.txt 指南

llm.txt 文件提供专为 AI Agent 设计的完整文档，其中包括：

• 完整的命令参考，包含参数和示例
• 环境变量用法模式
• 自动化最佳实践
• 错误处理与故障排查
• 批量操作模式

llm.txt 文件会根据 CLI 结构自动生成，并在每次发布时保持更新。

⚡ 使用示例

用例 1：通过 HTTP 暴露本地 stdio 服务

1. 将服务添加到 MCPM

mcpm new [MY_SERVER_NAME] --type stdio --command "[COMMAND]" --args "[ARG_1] [ARG_2] ..."

（添加 --force 参数以跳过确认交互） 验证服务是否出现在已安装服务列表中：

mcpm ls

你应该能在列表中看到 [MY_SERVER_NAME]。

2. 通过 HTTP 提供服务

mcpm run [MY_SERVER_NAME] --http

MCPM 会输出服务 URL，例如：

URL: http://127.0.0.1:6276/mcp/

3. 在网络上暴露该服务（可选）

mcpm run [MY_SERVER_NAME] --http --host 0.0.0.0

提示：添加 --port <PORT> 可选择其他端口。

用例 2：组合多个服务，并将其作为一个配置文件提供

1. 将服务添加到 MCPM

# Stdio server
mcpm new [SERVER_A] --type stdio --command "[COMMAND]" --args "[ARG_1] [ARG_2] ..." --force

# Remote HTTP/SSE server
mcpm new [SERVER_B] --type remote --url "http://SERVER_ADDR/mcp/" --force

2. 创建配置文件并添加服务 交互式操作：

mcpm profile create [PROFILE_NAME]
mcpm profile edit [PROFILE_NAME]

MCPM 会列出所有已安装的服务。你可以使用方向键导航，按空格键选择或取消选择，输入文字进行搜索，然后按 Enter 确认。

验证：

mcpm profile ls

你应该能看到包含所选服务的配置文件。

3. 运行配置文件

# Stdio
mcpm profile run [PROFILE_NAME]

# HTTP
mcpm profile run [PROFILE_NAME] --http

# Optional: host and port
mcpm profile run [PROFILE_NAME] --http --host 0.0.0.0 --port 8080

其他常见用法

# Server management
mcpm new myserver --type stdio --command "python -m server" --force
mcpm edit myserver --env "API_KEY=secret" --force

# Profile management  
mcpm profile edit web-dev --add-server myserver --force
mcpm profile run web-dev --port 8080

# Client integration
mcpm client edit cursor --add-profile web-dev --force

🗺️ 路线图

✅ v2.0 已完成

• 全局服务配置模型
• 基于配置文件的服务标记与组织
• 交互式命令界面
• 客户端集成管理（mcpm client edit）
• 采用一致 UX 的现代 CLI
• 注册表集成与服务发现
• 直接执行与共享服务
• 从现有客户端配置导入
• 支持更多客户端（gemini-cli、codex 等）

🔮 后续增强

• 服务更新管理（mcpm update）
• GitHub 发布二进制文件更新（下载并替换）
• 高级服务访问监控与分析
• 在 docker 中执行
• 将 MCPM 功能作为 MCP 服务暴露（搜索、安装、配置文件管理等）
• MCP 检查的 TUI 界面
• MCP 与配置文件管理的 TUI 界面

📦 其他安装方式

🍺 Homebrew

brew install mcpm

📦 pipx（推荐用于 Python 工具）

pipx install mcpm

🪄 uv tool

uv tool install mcpm

更多安装方式

🐍 pip

pip install mcpm

🧰 X-CMD

如果你是 x-cmd 用户，可以运行：

x install mcpm.sh

👨‍💻 开发

此仓库包含 MCP Manager 的 CLI 和服务组件，使用 Python 和 Click 构建，并遵循现代软件包开发实践。

📋 开发要求

• 🐍 Python 3.10+
• 🚀 uv（用于虚拟环境和依赖项管理）
• 🖱️ 用于命令行界面的 Click 框架
• ✨ 用于增强控制台输出的 Rich
• 🌐 用于 API 交互的 Requests

📁 项目结构

本项目采用现代化的基于 src 的布局：

mcpm.sh/
├── src/             # Source package directory
│   └── mcpm/        # Main package code
├── tests/           # Test directory
├── test_cli.py      # Development CLI runner
├── pyproject.toml   # Project configuration
├── pages/           # Website content
│   └── registry/    # Registry website
├── mcp-registry/    # MCP Registry data
└── README.md        # Documentation

🚀 开发环境设置

1. 克隆仓库

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

2. 使用 uv 设置虚拟环境

   uv venv --seed
   source .venv/bin/activate  # On Unix/Mac
   

3. 以开发模式安装依赖项

   uv pip install -e .
   

4. 在开发期间直接运行命令行界面

   # Either use the installed package
   mcpm --help
   
   # Or use the development script
   ./test_cli.py --help
   

5. 运行测试

   pytest tests/
   

✅ 最佳实践

• 📁 使用基于 src 的目录结构，避免导入混淆
• 🔧 使用 uv pip install -e . 以可编辑安装的方式进行开发
• 🧩 在 src/mcpm/commands/ 目录中保持命令模块化
• 🧪 在 tests/ 目录中为新功能添加测试
• 💻 使用 test_cli.py 脚本快速测试开发成果

🔢 版本管理

MCP 使用单一事实来源模式管理版本，以确保所有组件的版本一致。

🏷️ 版本结构

• 📍 规范版本定义在项目根目录的 version.py 中
• 📥 src/mcpm/__init__.py 会导入此版本
• 📄 pyproject.toml 使用动态版本管理，从 version.py 读取版本
• 🏷️ Git 标签使用相同的版本号，并在前面加上“v”（例如，v1.0.0）

🔄 更新版本

发布新版本时：

1. 使用提供的版本递增脚本

   ./bump_version.sh NEW_VERSION
   # Example: ./bump_version.sh 1.1.0
   

2. 推送更改和标签

   git push && git push --tags
   

3. 创建与新版本对应的 GitHub 发布

此流程可确保代码、软件包元数据和 git 标签中的版本保持一致。 PyPI 发布由 CI/CD 流水线处理，并会自动触发。

📜 许可证

MIT

Star 历史