mcp-serverman: A MCP Server Configuration Manager
LocalAbout mcp-serverman: A MCP Server Configuration Manager
mcp-serverman is a command-line tool for managing MCP server configurations for Claude and other clients, with version control and profiles. It also provides a companion MCP server so an LLM can manage configurations through conversation.
Key features
- 01Manage MCP server configuration
- 02List and filter servers
- 03Manage configuration versions
- 04Use configuration profiles
- 05Support multiple MCP clients
Use cases
- 01Check configured MCP servers
- 02Enable or disable a selected server
- 03Manage configurations for different clients
- 04Let an LLM manage configuration through the companion server
MCP support
Alongside its command-line manager, the project provides a companion MCP server that lets an LLM manage MCP server configurations.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmcp-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
- Add support for other MCP-Clients, e.g. Cline and MCP-Bridge (since 0.1.9)
- Update the code to be more modular and easier to maintain (since v0.2.0)
- 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)
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.