mcp-builder

一个基于 Python 的 MCP 服务器，用于安装其他 MCP 服务器。

此服务器的目的是提供一种完整、用户友好且跨平台的方式来安装和配置 MCP 服务器。

TODO

• [ ] 支持更多 MCP 客户端（例如 Cursor、Windsurf 等）
• [ ] 支持更多 MCP 服务器类型和来源（例如 Node.js、Java 等）
• [ ] 支持失败安装的恢复机制
• ...

特性

• 包仓库安装: 从 PyPI 或 npm 包安装 MCP 服务器
• 本地安装: 从本地目录安装 MCP 服务器
• 配置管理: 为已安装的服务器配置环境变量和参数
• 自动检测: 自动检测 MCP 服务器的类型（Node.js 或 Python）
• 跨平台支持: 适用于 Windows、macOS 和 Linux

要求

• Python 3.10 或更高版本
• pip (用于 Python 包)
• Node.js 和 npm (可选，用于 JavaScript 包)

安装

从源码安装

git clone https://github.com/xd3an/mcp-builder.git
cd mcp-builder
pip install -e .

使用

直接运行

安装完成后，您可以直接运行 MCP Builder：

# 使用入口点
mcpbuilder

# 或者作为模块
python -m mcp_builder.server

开发模式

对于开发和测试，您可以使用 MCP CLI 工具：

# 安装 MCP CLI 工具
pip install "mcp[cli]"

# 在开发模式下运行
mcp dev path/to/mcp_builder/server.py

# npx @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector python -m mcp_builder.server

MCP 客户端集成

Claude Desktop 集成

要将 MCP Builder 与 Claude Desktop 一起使用，请将其添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "mcp-builder": {
      "command": "python",
      "args": [
        "-m",
        "mcp_builder.server"
      ]
    }
  }
}

配置文件位于：

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

示例命令

与 Claude Desktop 集成后，您可以要求 Claude 执行以下操作：

read https://github.com/microsoft/playwright-mcp help me install playwright-mcp in my claude config

工作原理

MCP Builder 修改 Claude Desktop 配置文件以注册 MCP 服务器。 它支持：

1. Node.js 包: 使用 npx 安装并配置 Claude 以使用它们
2. Python 包: 配置 Claude 以使用 Python 模块
3. 本地仓库: 安装依赖项并配置 Claude 以使用本地代码