我们解决什么问题？

解决为不同MCP客户端手动编辑各种JSON文件的麻烦

管理跨多个AI客户端（如Claude Code、Gemini CLI等）的模型上下文协议服务器时，需要手动为每个客户端编辑独立的JSON配置文件。这既繁琐又容易出错，且难以维护。

为什么选择MCP服务器管理员？

• ✅ 单一二进制 - 无依赖，只需下载并运行
• ✅ 单一简单配置文件 - 一个YAML文件控制一切
• ✅ 所有操作系统 - 支持 Linux、macOS、Windows
• ✅ 所有MCP客户端 - 支持Claude代码、Gemini CLI等
• ✅ GUI 接口 - 网页界面从计算机开始，始终可在本地主机上使用：6543
• ✅ 暗/亮主题 - 系统主题检测带手动覆盖
• ✅ 通过网页界面添加服务器 - 无需手动编辑配置文件
• ✅ 实时验证 - 对配置错误的即时反馈
• ✅ 示例配置 - 常见服务器类型的内置示例

截图

网页界面提供了一种直观的方式，可以管理和添加跨多个AI客户端的MCP服务器，并实现实时验证

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