mcp-manager 0.2.0

A CLI tool for managing Model Context Protocol (MCP) servers

MCP Manager

A CLI tool that makes MCP server management across Claude Desktop, Cursor, and more dead simple.

Installation • Quick Start • Available Servers • Supported MCP Clients

🚀 Quick Start

# Install the package
pip install mcp-manager

# Search for available servers
mcp-manager search browser
# ┌───────────┬──────────────────────────────────────────────┬────────────┐
# │ Server    │ Description                                  │ Maintainer │
# ├───────────┼──────────────────────────────────────────────┼────────────┤
# │ playwright│ MCP server for browser automation            │ Anthropic  │
# └───────────┴──────────────────────────────────────────────┴────────────┘

# Get detailed server information
mcp-manager info playwright
# ╭────────────────────── Server Information ──────────────────────╮
# │ Server: playwright                                             │
# │ Description: MCP server for browser automation with Playwright │
# │ Maintainer: Anthropic                                          │
# ╰────────────────────────────────────────────────────────────────╯
# Dependencies
#  •  Node.js
#  •  npm

# Install a server (for Claude Desktop)
mcp-manager install playwright --client=claude-desktop

# Install a server (for Cursor)
mcp-manager install playwright --client=cursor

# Install a server (for Claude Code)
mcp-manager install playwright --client=claude-code

🛠️ Available Commands

Command	Description
search <keyword>	Search for available MCP servers matching the keyword
info <server-name>	Display detailed information about a specific server
install <server-name> [--client=claude-desktop|cursor|claude-code]	Install an MCP server for a specific client
uninstall <server-name> [--client=claude-desktop|cursor|claude-code]	Remove an installed server
list	List all installed MCP servers
config path [--client=claude-desktop|cursor|claude-code]	Show current client config file path
config set-path <new-path> [--client=claude-desktop|cursor|claude-code]	Set a new path for the client config file

🔌 Available Servers

Server	Description	Dependencies
Playwright	Browser automation server for web interactions	Node.js, npm
Filesystem	File system operations server for local file access	Node.js, npm
Fetch	Server for making HTTP requests	Docker
Git	Server for Git operations	Docker
GitHub	Server for GitHub API operations	Docker
Memory	Server for managing Claude's memory	Docker

👥 Supported MCP Clients

Currently supports:

• ✅ Claude Desktop (default client)
• ✅ Cursor
• ✅ Claude Code

🎯 Features

• 🔍 Smart server discovery and search
• 🔒 Secure configuration management
• 🔄 Automatic dependency checking
• 🛡️ Client-specific installation options
• 📝 Detailed server information and documentation

💻 Installation

For users:

pip install mcp-manager

For developers:

# Clone the repository
git clone https://github.com/nstebbins/mcp-manager.git
cd mcp-manager

# Install dependencies and development tools
poetry install
pre-commit install  # Install git hooks

Code Quality

We maintain high code quality standards through automated checks:

# Run all pre-commit hooks
pre-commit run --all-files

# Format code
poetry run ruff format .

# Run linter
poetry run ruff check .

# Run tests
poetry run pytest

🧪 Testing

The project uses pytest for testing. Run the test suite with:

poetry run pytest

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.