MCP Server Manager

What Problem Do We Solve?

Solve the hassle of manually editing various JSON files for different MCP clients

Managing Model Context Protocol servers across multiple AI clients (Claude Code, Gemini CLI, etc.) requires manually editing separate JSON configuration files for each client. This is tedious, error-prone, and hard to maintain.

Why Choose MCP Server Manager?

• ✅ Single Binary - No dependencies, just download and run
• ✅ Single Simple Config File - One YAML file controls everything
• ✅ All Operating Systems - Works on Linux, macOS, Windows
• ✅ All MCP Clients - Supports Claude Code, Gemini CLI, and more
• ✅ GUI Interface - Web interface starts with computer, always available on localhost:6543
• ✅ Dark/Light Theme - System theme detection with manual override
• ✅ Add Servers via Web UI - No need to edit configuration files manually
• ✅ Real-time Validation - Instant feedback on configuration errors
• ✅ Example Configurations - Built-in examples for common server types

Screenshot

The web interface provides an intuitive way to manage and add MCP servers across multiple AI clients with real-time validation

Installation Options

Option 1: Debian/Ubuntu Package (Recommended)

# Download the latest .deb from GitHub Releases
wget https://github.com/vlazic/mcp-server-manager/releases/latest/download/mcp-server-manager_Linux_x86_64.deb

# Install the package
sudo dpkg -i mcp-server-manager_Linux_x86_64.deb

# Enable and start the service
systemctl --user enable --now mcp-server-manager

Option 2: Download Release Binary

# Download and extract
wget https://github.com/vlazic/mcp-server-manager/releases/latest/download/mcp-server-manager_Linux_x86_64.tar.gz
tar -xzf mcp-server-manager_Linux_x86_64.tar.gz
chmod +x mcp-server-manager

# Run directly (config will be auto-created)
./mcp-server-manager

# Or specify custom config location
./mcp-server-manager --config /path/to/config.yaml
./mcp-server-manager -c /path/to/config.yaml

Option 3: Build from Source

git clone https://github.com/vlazic/mcp-server-manager.git
cd mcp-server-manager

# Build only
make build

# Build, install, and start as system service
make setup

Configuration

Config File Locations (Smart Resolution)

The application automatically finds your configuration file in this priority order:

1. Command line flag: --config /path/to/config.yaml or -c /path/to/config.yaml
2. User config: ~/.config/mcp-server-manager/config.yaml (recommended)
3. Current directory: ./config.yaml
4. Embedded default: Auto-created if none found

First Run

On first run, a default configuration will be automatically created at:

~/.config/mcp-server-manager/config.yaml

Edit this file to configure your MCP servers and client paths.

How It Works