MCP Builder

🚀 mcp-builder

mcp-builder 是一個基於 Python 的 MCP 服務器，旨在為用戶提供一種完整、友好且跨平臺的方式來安裝和配置 MCP 服務器。

🚀 快速開始

mcp-builder 可幫助你輕鬆安裝其他 MCP 服務器。在開始前，請確保滿足以下先決條件：

• 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 執行示例命令，例如：

讀取 https://github.com/microsoft/playwright-mcp 並幫助我將其安裝到我的 claude 配置中。

✨ 主要特性

• 包倉庫安裝：支持從 PyPI 或 npm 包安裝 MCP 服務器。
• 本地安裝：可從本地目錄安裝 MCP 服務器。
• 配置管理：能夠配置環境變量和參數以用於已安裝的服務器。
• 自動檢測：可自動檢測 MCP 服務器類型（Node.js 或 Python）。
• 跨平臺支持：在 Windows、macOS 和 Linux 上均可使用。

📦 安裝指南

從源代碼安裝

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

💻 使用示例

基礎用法

直接運行

# 使用入口點
mcpbuilder

# 或者作為模塊運行
python -m mcp_builder.server

高級用法

開發模式

# 安裝 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

Claude Desktop 集成

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

🔧 技術細節

MCP Builder 通過修改 Claude Desktop 的配置文件來註冊 MCP 服務器，具體支持以下功能：

1. Node.js 包：使用 npx 安裝並配置 Claude 使用它們。
2. Python 包：配置 Claude 使用 Python 模塊。
3. 本地倉庫：安裝依賴項並配置 Claude 使用本地代碼。

📄 待辦事項

• [ ] 支持更多 MCP 客戶端（例如：Cursor, Windsurf 等）
• [ ] 支持更多 MCP 服務器類型和來源（例如 Node.js、Java 等）
• [ ] 支持故障安裝的恢復機制
• ...