English | 简体中文
Open Source. Forever Free.
Built with ❤️ by Path Integral Institute
🌟 MCPM - Model Context Protocol Manager
MCPM is an open source CLI tool for managing MCP servers. It provides a simplified global configuration approach where you install servers once and organize them with profiles, then integrate them into any MCP client. Features include server discovery through a central registry, direct execution, sharing capabilities, and client integration tools.
Demo is showing outdated v1 commands, new demo is baking ...
🤝 Community Contributions💡 Grow the MCP ecosystem! We welcome contributions to our MCP Registry. Add your own servers, improve documentation, or suggest features. Open source thrives with community participation!
curl -sSL https://mcpm.sh/install | bash
Or choose other installation methods like brew
, pipx
, uv
etc.
MCPM v2.0 provides a simplified approach to managing MCP servers with a global configuration model. Key features include:
MCPM v2.0 eliminates the complexity of v1's target-based system in favor of a clean global workspace model.
🖥️ Supported MCP ClientsMCPM will support managing MCP servers for the following clients:
MCPM provides a comprehensive CLI with a clean, organized interface. The v2.0 architecture uses a global configuration model where servers are installed once and can be organized with profiles, then integrated into specific MCP clients as needed.
mcpm --help # Display help information and available commands mcpm --version # Display the current version of MCPM
Global server installation and management commands:
# 🔍 Search and Install mcpm search [QUERY] # Search the MCP Registry for available servers mcpm info SERVER_NAME # Display detailed information about a server mcpm install SERVER_NAME # Install a server from registry to global configuration mcpm uninstall SERVER_NAME # Remove a server from global configuration # 📋 List and Inspect mcpm ls # List all installed servers and their profile assignments mcpm edit SERVER_NAME # Edit a server configuration mcpm inspect SERVER_NAME # Launch MCP Inspector to test/debug a server
Execute servers directly for testing or integration:
mcpm run SERVER_NAME # Execute a server directly over stdio mcpm run SERVER_NAME --http # Execute a server over HTTP for testing mcpm share SERVER_NAME # Share a server through secure tunnel for remote access mcpm usage # Display comprehensive analytics and usage data
Profiles are virtual tags that organize servers into logical groups for different workflows:
# 🔄 Profile Operations mcpm profile ls # List all profiles and their tagged servers mcpm profile create PROFILE # Create a new profile mcpm profile rm PROFILE # Remove a profile (servers remain installed) mcpm profile edit PROFILE # Interactive server selection for profile # 🚀 Profile Execution mcpm profile run PROFILE # Execute all servers in a profile over stdio or HTTP mcpm profile share PROFILE # Share all servers in a profile through secure tunnel mcpm profile inspect PROFILE # Launch MCP Inspector for all servers in profile
Manage MCP client configurations (Claude Desktop, Cursor, Windsurf, etc.):
mcpm client ls # List all supported MCP clients and their status mcpm client edit CLIENT_NAME # Interactive server enable/disable for a client mcpm client edit CLIENT_NAME -e # Open client config in external editor mcpm client import CLIENT_NAME # Import server configurations from a client🛠️ System & Configuration
mcpm doctor # Check system health and server status mcpm config # Manage MCPM configuration and settings mcpm migrate # Migrate from v1 to v2 configuration
The MCP Registry is a central repository of available MCP servers that can be installed using MCPM. The registry is available at mcpm.sh/registry.
MCPM is designed to be AI agent friendly with comprehensive automation support. Every interactive command has a non-interactive alternative using CLI parameters and environment variables.
Set environment variables to enable full automation:
export MCPM_NON_INTERACTIVE=true # Disable all interactive prompts export MCPM_FORCE=true # Skip confirmations export MCPM_JSON_OUTPUT=true # JSON output for parsing
The llm.txt file provides comprehensive documentation specifically designed for AI agents, including:
The llm.txt file is automatically generated from the CLI structure and kept up-to-date with each release.
# Server management mcpm new myserver --type stdio --command "python -m server" --force mcpm edit myserver --env "API_KEY=secret" --force # Profile management mcpm profile edit web-dev --add-server myserver --force mcpm profile run web-dev --port 8080 # Client integration mcpm client edit cursor --add-profile web-dev --force
mcpm client edit
)If you are a user of x-cmd, you can run:
This repository contains the CLI and service components for MCP Manager, built with Python and Click following modern package development practices.
📋 Development RequirementsThe project follows the modern src-based layout:
mcpm.sh/
├── src/ # Source package directory
│ └── mcpm/ # Main package code
├── tests/ # Test directory
├── test_cli.py # Development CLI runner
├── pyproject.toml # Project configuration
├── pages/ # Website content
│ └── registry/ # Registry website
├── mcp-registry/ # MCP Registry data
└── README.md # Documentation
Clone the repository
git clone https://github.com/pathintegral-institute/mcpm.sh.git
cd mcpm.sh
Set up a virtual environment with uv
uv venv --seed
source .venv/bin/activate # On Unix/Mac
Install dependencies in development mode
Run the CLI directly during development
# Either use the installed package
mcpm --help
# Or use the development script
./test_cli.py --help
Run tests
uv pip install -e .
src/mcpm/commands/
directorytests/
directorytest_cli.py
script for quick development testingMCP uses a single source of truth pattern for version management to ensure consistency across all components.
version.py
at the project rootsrc/mcpm/__init__.py
imports this versionpyproject.toml
uses dynamic versioning to read from version.py
When releasing a new version:
Use the provided version bump script
./bump_version.sh NEW_VERSION
# Example: ./bump_version.sh 1.1.0
Push the changes and tags
git push && git push --tags
Create a GitHub release matching the new version
This process ensures that the version is consistent in all places: code, package metadata, and git tags. PyPI release is handled by the CI/CD pipeline and will be triggered automatically.
MIT
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4