mcp-builder

A Python based MCP server to install other MCP servers. This server allows Claude to install and configure other MCP servers from package repositories (PyPI or npm) or from local directories.

Features

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

Requirements

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

Installation

Install from Source

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

Usage

Running Directly

After installation, you can run the MCP Builder directly:

# Using the entry point
mcpbuilder

# Or as a module
python -m mcp_builder.server

Development Mode

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

# Install MCP CLI tools
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

Claude Desktop Integration

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

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

The configuration file is located at:

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

Example Commands

Once integrated with Claude Desktop, you can ask Claude to:

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

How It Works

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

1. Node.js Packages: Installs using npx and configures Claude to use them
2. Python Packages: Configures Claude to use Python modules
3. Local Repositories: Installs dependencies and configures Claude to use local code