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  
mcp-serverman disable 
mcp-serverman remove 
# Version control
mcp-serverman save  --comment 
mcp-serverman change  --version 
# Preset/Profile management
mcp-serverman preset save 
mcp-serverman preset load 
mcp-serverman preset delete 
# Multiple client support(since 0.1.9)
mcp-serverman client list
mcp-serverman client add  --name "Display Name" --path "/path/to/config.json" --key "mcpServers" [--default]
mcp-serverman client remove 
mcp-serverman client modify  --default
mcp-serverman client copy --from  --to  --merge
# Register companion mcp server to let Claude/LLM manage for you(since 0.2.1)
mcp-serverman companion [--client ]

For detailed usage instructions, see the manual.

:robot: Install as a mcp server

# Install companion (since 0.2.1)
mcp-serverman companion [--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)