What is Mcp Serverman

mcp-serverman is a command-line interface (CLI) tool designed for managing MCP server JSON configuration files. It offers features such as version control, profile management, and multi-client support.

Use cases

Use cases for mcp-serverman include managing configurations for multiple MCP servers, automating server management tasks through the companion server, and maintaining version history for configuration changes.

How to use

To use mcp-serverman, first install it via pip with ‘pip install mcp-serverman’. After installation, you can run commands like ‘mcp-serverman client init’ to initialize client configuration, ‘mcp-serverman list’ to list servers, and various commands for version control and profile management.

Key features

Key features include version control for server configurations, the ability to manage multiple clients, preset/profile management, and a companion MCP server that allows LLMs to manage configurations automatically.

Where to use

undefined

mcp-serverman: A MCP Server Configuration Manager

A command-line tool to manage Claude MCP servers configuration with version control and profiling. Now also has a companion mcp server to let llms config for you.

[!IMPORTANT]
I always recommend making a manual backup of the mcp configuration before making any changes. Although I tried to cover some error handling in the code, it is definitely not inclusive.

:floppy_disk:Installation

pip install mcp-serverman 

or from GitHub for the latest debug version:

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

Should be available on Windows, Linux(tested) and MacOS. If the path for a certain platform is wrong, open an issue.

:computer: Cli usage

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

# Display help message
mcp-serverman
# Initialize Client configuration(one time and must be done before using other commands, since 0.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 0.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 0.2.1)
mcp-serverman companion [--client <client>]

For detailed usage instructions, see the manual.

:robot: Install as a mcp server

# Install companion (since 0.2.1)
mcp-serverman companion [--client <client>]

Example:

• What mcp servers do I have?
• Disable xxx, xxx server for me.

:wrench:Development

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

pip install -e .

:checkered_flag:Roadmap

• [x] Add support for other MCP-Clients, e.g. Cline and MCP-Bridge (since 0.1.9)
• [x] Update the code to be more modular and easier to maintain (since v0.2.0)
• [x] Added our own mcp-server to let Claude/LLM manage for you (since 0.2.1)
• [ ] Better error handling tests
• Integration with other MCP server install tools, e.g. Smithery, or with predefined installation templates (should iron out safety issues first) We have so many mcp marketplaces now, just use mcp-installer package and instruct the model to install it for you.
• Maybe a Web UI via Flask?

License

MIT License (LICENSE)