https://github.com/benhaotang/mcp-serverman
a cli/mcp server tool for managing mcp server json config file with version control, profiles and multi-client support
https://github.com/benhaotang/mcp-serverman
claude mcp mcp-server
Last synced: 6 months ago
JSON representation
a cli/mcp server tool for managing mcp server json config file with version control, profiles and multi-client support
- Host: GitHub
- URL: https://github.com/benhaotang/mcp-serverman
- Owner: benhaotang
- License: mit
- Created: 2025-01-18T22:34:49.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-24T14:55:00.000Z (7 months ago)
- Last Synced: 2025-04-10T15:16:59.459Z (6 months ago)
- Topics: claude, mcp, mcp-server
- Language: Python
- Homepage:
- Size: 61.5 KB
- Stars: 8
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-serverman** - a cli/mcp server tool for managing mcp server json config file with version control, profiles and multi-client support `python` `claude` `mcp` `mcp-server` `server` `pip install git+https://github.com/benhaotang/mcp-serverman` (AI/ML)
- awesome-mcp-servers - **mcp-serverman** - a cli/mcp server tool for managing mcp server json config file with version control, profiles and multi-client support `python` `claude` `mcp` `mcp-server` `server` `pip install git+https://github.com/benhaotang/mcp-serverman` (AI/ML)
README
# mcp-serverman: A MCP Server Configuration Manager
[](https://pypi.org/project/mcp-serverman/) [](https://pypi.org/project/mcp-serverman/)   
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
```bash
pip install mcp-serverman
```
or from GitHub for the latest debug version:
```bash
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:
```bash
# 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](https://github.com/benhaotang/mcp-serverman/blob/main/Manual.md).
## :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:
```bash
pip install -e .
```
## :checkered_flag:Roadmap
- [x] Add support for other MCP-Clients, e.g. [Cline](https://github.com/cline/cline) and [MCP-Bridge](https://github.com/SecretiveShell/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](https://github.com/anaisbetts/mcp-installer) package and instruct the model to install it for you.
- ~~Maybe a Web UI via Flask?~~
## License
MIT License [(LICENSE)](https://github.com/benhaotang/mcp-serverman/blob/main/LICENSE)