Install MCP

🚀 安装 MCP

通过你的 AI 代理管理 MCP 服务器的最简单方法

Install MCP 是一个元 MCP 服务器，它能让 AI 代理为你安装、配置和管理其他 MCP 服务器。无需再手动编辑 JSON 或进行复杂的命令行安装，只需让你的 AI 助手来处理即可。

✨ 主要特性

• 以代理为优先的设计：只需向你的 AI 发出指令，即可安装和管理 MCP 服务器。
• 通用兼容性：可与 Claude Desktop、Claude Code、Cursor 和 Windsurf 兼容。
• 集中管理：所有配置和机密信息都存储在一处。
• 安全的机密处理：通过基于 Web 的安全方式收集 API 密钥和令牌。
• 一键安装：使用简单命令，数秒即可开始使用。
• 导出/导入设置：可与团队共享你的 MCP 配置。

📦 安装指南

我们的安装程序会自动设置 uv（快速 Python 包管理器）并为你完成所有配置。

macOS/Linux

curl -sSL https://raw.githubusercontent.com/ddfourtwo/install-mcp/main/install.sh | bash

Windows

powershell -c "irm https://raw.githubusercontent.com/ddfourtwo/install-mcp/main/install.ps1 | iex"

安装程序的操作内容：

• ✅ 若未安装 uv，则进行安装（超快的 Python 包管理器）
• ✅ 永久将 uv 添加到你的 PATH 环境变量中
• ✅ 下载并配置 install-mcp
• ✅ 设置服务器以使用 uvx 实现即时启动
• ✅ 自动配置所有 MCP 客户端

安装完成后：

1. 重启你的 MCP 客户端（Claude Desktop、Cursor 等）
2. 询问你的 AI：“你能测试 install-mcp 服务器吗？”
3. 你已准备好安装任何 MCP 服务器！

💻 使用示例

安装完成后，只需向你的 AI 助手发出以下指令：

安装服务器

"为我安装 GitHub MCP 服务器"
"你能设置 Slack MCP 服务器吗？"
"我需要安装文件系统 MCP 服务器"

管理配置

"显示我所有已安装的 MCP 服务器"
"导出我的 MCP 设置以便我能共享"
"在我所有的 MCP 客户端中配置 GitHub 服务器"

处理机密信息

"收集 OpenAI 服务器的 API 密钥"
"更新我的 GitHub MCP 服务器的 GitHub 令牌"

📚 详细文档

• 架构指南 - 带有图表的技术概述
• API 参考 - 所有可用工具的详细文档

🚀 为什么选择 uv？

我们使用 uv 作为 Python 包管理器，因为它具有以下特点：

• 速度快 10 - 100 倍：安装在数秒内完成，而非数分钟
• 通用性强：单个二进制文件，可在任何地方使用
• 现代化：用 Rust 构建，具有正确的依赖解析功能
• 方便：uvx 的使用方式与 npx 类似，可用于运行 Python 工具

安装程序运行后，你可以在任何地方使用 uvx：

# 立即运行任何 Python 工具
uvx ruff check
uvx black --version
uvx install-mcp  # 此服务器！

🔧 技术细节

Install MCP 充当 MCP 服务器的包管理器：

1. 安装：处理 git 克隆、npm 安装和依赖管理
2. 配置：维护一个中央配置文件，该文件会同步到所有 MCP 客户端
3. 机密管理：安全地收集 API 密钥并将其存储在中央 .env 文件中
4. 客户端更新：自动更新 Claude Desktop、Cursor 和其他 MCP 客户端

目录结构

~/mcp-servers/
├── install-mcp/          # 此元服务器
├── mcp-servers-config.json  # 中央配置
├── .env                  # 中央机密信息（安全）
├── github/              # 示例：GitHub MCP 服务器
├── slack/               # 示例：Slack MCP 服务器
└── ...                  # 其他已安装的服务器

可用的 AI 命令

你的 AI 助手可以使用以下工具：

支持的服务器类型

Install MCP 可以处理各种 MCP 服务器类型：

NPM 包

# 发布到 npm 的服务器
命令：npx -y @organization/package-name@latest

GitHub 仓库（Node.js）

# 带有 package.json 的服务器
1. 克隆仓库
2. 运行 npm install
3. 运行 npm build（如果需要）
4. 配置为：node path/to/server.js

GitHub 仓库（Python）

# 带有 requirements.txt 的服务器
1. 克隆仓库
2. 运行 pip install -r requirements.txt
3. 配置为：python3 path/to/server.py

预构建的可执行文件

# 独立二进制文件
通过可执行文件的直接路径进行配置

安全措施

• 机密信息在 AI 对话中永不暴露
• API 密钥通过仅本地的 Web 界面收集
• 机密信息以严格的权限（0600）存储
• 每个服务器的机密信息都有命名空间（例如，GITHUB_TOKEN → GITHUB_GITHUB_TOKEN）

🤝 贡献代码

我们欢迎贡献！详情请参阅我们的 贡献指南。

开发环境设置

# 克隆仓库
git clone https://github.com/ddfourtwo/install-mcp.git
cd install-mcp

# 安装依赖
cd server
pip install -r requirements.txt

运行测试

python test_meta_mcp.py

📋 故障排除

MCP 客户端无法识别服务器？

• 确保安装后已重启 MCP 客户端
• 检查安装路径是否正确：~/mcp-servers/install-mcp/
• 验证是否安装了 Python 3.11+：python3 --version

机密信息无法使用？

• 检查中央 .env 文件：~/mcp-servers/.env
• 确保机密信息有正确的命名空间（例如，GITHUB_GITHUB_TOKEN）
• 验证文件权限：ls -la ~/mcp-servers/.env（应为 -rw-------）

无法安装特定服务器？

• 运行 list_mcp_servers() 检查当前状态
• 确保你拥有所需的工具（git、npm、python3）
• 检查服务器 README 中的特定要求

🌐 生态系统

Install MCP 是不断发展的 MCP（模型上下文协议）生态系统的一部分：

• MCP 规范
• Awesome MCP 服务器
• Claude Desktop

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🙏 致谢

• 基于 FastMCP 框架构建
• 受简化 MCP 服务器管理需求的启发
• 感谢所有贡献者和早期采用者

为 AI 辅助开发社区用心打造 ❤️

请记住：AI 工具的最佳交互方式是自然语言。让你的 AI 助手处理复杂事务！