Content
# mcp-builder
A Python-based MCP server to install 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.
<a href="https://glama.ai/mcp/servers/@XD3an/mcp-builder">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@XD3an/mcp-builder/badge" alt="Builder MCP server" />
</a>
#### TODO
- [ ] Support for more MCP Clients (e.g. Cursor, Windsurf, ...)
- [ ] Support for more MCP server types and sources (e.g., Node.js, Java, etc.)
- [ ] Support recovery mechanism for failed installations
- ...
## 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
```bash
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:
```bash
# 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:
```bash
# 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
```
### MCP Client Integration
#### Claude Desktop Integration
To use MCP Builder with Claude Desktop, add it to your `claude_desktop_config.json` file:
```json
{
"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
Connection Info
You Might Also Like
MarkItDown MCP
Converting files and office documents to Markdown.
Time
Obtaining current time information and converting time between different...
Filesystem
Model Context Protocol Servers
Sequential Thinking
Offers a structured approach to dynamic and reflective problem-solving,...
Git
Model Context Protocol Servers
Context 7
Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors