MCP Builder

🚀 mcp-builder

A Python-based MCP server for installing other MCP servers.

The purpose of this server is to provide a complete, user-friendly, and cross-platform way to install and configure MCP servers.

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• pip (for Python packages)
• Node.js and npm (optional, for JavaScript packages)

Installation

Install from Source Code

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

Usage

Run Directly

After installation, you can directly run MCP Builder:

# Use the entry point
mcpbuilder

# Or run as a module
python -m mcp_builder.server

Development Mode

For development and testing, you can use the MCP CLI tool:

# Install the MCP CLI tool
pip install "mcp[cli]"

# Run in development mode
mcp dev path/to/mcp_builder/server.py

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

MCP Client Integration

Claude Desktop Integration

To use MCP Builder with Claude Desktop, add it to the claude_desktop_config.json file:

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

The location of the configuration file is:

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

Example Command

Once integrated with Claude Desktop, you can ask Claude to perform the following operation:

Read https://github.com/microsoft/playwright-mcp and help me install it into my claude configuration.

✨ Features

• Package Repository Installation: Install MCP servers from PyPI or npm packages.
• Local Installation: Install MCP servers from a local directory.
• Configuration Management: Configure environment variables and parameters for the installed servers.
• Automatic Detection: Automatically detect the MCP server type (Node.js or Python).
• Cross-platform Support: Available on Windows, macOS, and Linux.

📋 To-Do List

• [ ] Support more MCP clients (e.g., Cursor, Windsurf, etc.)
• [ ] Support more MCP server types and sources (e.g., Node.js, Java, etc.)
• [ ] Support a recovery mechanism for failed installations
• ...

🔧 Technical Details

MCP Builder modifies the Claude Desktop configuration file to register MCP servers. It supports the following features:

1. Node.js Packages: Install and configure Claude to use them with npx.
2. Python Packages: Configure Claude to use Python modules.
3. Local Repositories: Install dependencies and configure Claude to use local code.