📌Overview

Purpose: A command-line tool designed to manage Claude MCP servers' configuration with version control and profiling.

Overview: MCP Serverman streamlines the management of MCP server configurations through a comprehensive CLI interface, allowing users to easily enable, disable, and manage server settings while ensuring that configurations can be version-controlled. It also supports integration with a companion server for interactive configuration management via language models.

Key Features:

• Version Control: Provides commands to save server configurations and switch between versions, ensuring easy rollback and configuration tracking.

• Profile Management: Allows users to create, load, and delete presets, facilitating the management of multiple configuration profiles seamlessly.

• Multiple Client Support: Enables management of different clients and their configurations from a single command line, enhancing versatility and control for managing multiple setups.

• Companion Server Integration: Offers a companion server feature that allows AI-driven configuration management, making it easier to modify settings without manual input.

---

mcp-serverman: A MCP Server Configuration Manager

A command-line tool to manage Claude MCP servers configuration with version control and profiling. It also includes a companion MCP server to let LLMs configure for you.

Important:
Always make a manual backup of the MCP configuration before making any changes. Some error handling is included but not comprehensive.

Installation

pip install mcp-serverman 

Or install the latest debug version from GitHub:

pip install git+https://github.com/benhaotang/mcp-serverman.git

The tool is available for Windows, Linux (tested), and MacOS. If a platform path is wrong, please open an issue.

CLI Usage

After installation, use the mcp-serverman command directly in the terminal:

# Display help message
mcp-serverman

# Initialize Client configuration (one-time, must be done before other commands, since v0.1.9)
mcp-serverman client init

# List servers
mcp-serverman list
mcp-serverman list --enabled

# Enable/disable/remove server/server version
mcp-serverman enable <server_name> 
mcp-serverman disable <server_name>
mcp-serverman remove <server_name>

# Version control
mcp-serverman save <server_name> --comment <comment>
mcp-serverman change <server_name> --version <version>

# Preset/Profile management
mcp-serverman preset save <preset_name>
mcp-serverman preset load <preset_name>
mcp-serverman preset delete <preset_name>

# Multiple client support (since v0.1.9)
mcp-serverman client list
mcp-serverman client add <short_name> --name "Display Name" --path "/path/to/config.json" --key "mcpServers" [--default]
mcp-serverman client remove <short_name>
mcp-serverman client modify <short_name> --default
mcp-serverman client copy --from <short_name> --to <short_name> --merge

# Register companion MCP server to let Claude/LLM manage for you (since v0.2.1)
mcp-serverman companion [--client <client>]

For detailed usage instructions, see the manual:
https://github.com/benhaotang/mcp-serverman/blob/main/Manual.md

Install as a MCP Server

To install the companion server (since v0.2.1):

mcp-serverman companion [--client <client>]

Examples include querying what MCP servers you have, or instructing the tool to disable specific servers.

Development

To install the package in development mode, clone the repository and run:

pip install -e .

Roadmap

• Support for other MCP-Clients, e.g. Cline and MCP-Bridge (since v0.1.9)
• Refactor code to be modular and easier to maintain (since v0.2.0)
• Added own MCP server to let Claude/LLM manage for you (since v0.2.1)
• Better error handling tests
• Integration with other MCP server installation tools, e.g. Smithery, or predefined installation templates (considering safety issues first)
  Recommendation: Use mcp-installer for installing MCP marketplaces.
• Potential Web UI via Flask (TBD)

License

MIT License
https://github.com/benhaotang/mcp-serverman/blob/main/LICENSE