Skip to main content

A tool to manage Claude MCP servers configuration

Project description

mcp-serverman: A MCP Server Configuration Manager

PyPI - Version PyPI - Downloads PyPI - License

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.

image

: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)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_benhaotang_mcp_serverman-0.2.2.tar.gz (16.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_benhaotang_mcp_serverman-0.2.2.tar.gz.

File metadata

  • Download URL: iflow_mcp_benhaotang_mcp_serverman-0.2.2.tar.gz
  • Upload date:
  • Size: 16.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_benhaotang_mcp_serverman-0.2.2.tar.gz
Algorithm Hash digest
SHA256 f55fb1175f935da6fe4a27a348aec8878603993cae45ec2c91c986369079c310
MD5 eb05f36e7131aee29300b7ea0a2561e4
BLAKE2b-256 fad779b70054d0e40f0f45909941b389f4f2d8a06fabdcdb1cf9b8bb37e90ef9

See more details on using hashes here.

File details

Details for the file iflow_mcp_benhaotang_mcp_serverman-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_benhaotang_mcp_serverman-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 18.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_benhaotang_mcp_serverman-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8a76621abc1a0e82f2610652274615d9ca4626f70a082e5357f2fa7ab71ed49c
MD5 89d5fd9b3e62c877345523b9dfda20cc
BLAKE2b-256 c36d33af54def28eba17b02be006d67c2dcd0d953804c96fa0353984c195abb9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page