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.3.tar.gz (16.1 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.3.tar.gz.

File metadata

  • Download URL: iflow_mcp_benhaotang_mcp_serverman-0.2.3.tar.gz
  • Upload date:
  • Size: 16.1 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.3.tar.gz
Algorithm Hash digest
SHA256 5a6ec1a422d21606ebfe3e1875f1735bc37c25e420353dde58cd44113a71a39e
MD5 c393a1ab2e9d87a082182da2eaa951ad
BLAKE2b-256 d4424a751fdce1e79e56421820a6b1e0d87297968ed1d61dd2d219f90bbc23b9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iflow_mcp_benhaotang_mcp_serverman-0.2.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 54d1b07ecbeaccb0e4605427f253dbead1f907589a3565ebb1a049964f6e28e3
MD5 cf70cfc1dec5759ad83a37e70e02bd30
BLAKE2b-256 bdd3a1cdac7caf568dabe46342812c1973c7aa7e909825655f636f0ca29b16b3

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