# MCP Manager [![Version](https://img.shields.io/badge/version-0.2.6-blue.svg)](https://pypi.org/project/mcp-manager/) [![Python](https://img.shields.io/badge/python-^3.9-blue.svg)](https://www.python.org/downloads/) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Tests](https://github.com/nstebbins/mcp-manager/actions/workflows/test.yml/badge.svg)](https://github.com/nstebbins/mcp-manager/actions/workflows/test.yml) A CLI tool that makes MCP server management across Claude Desktop, Cursor, and more dead simple. [Installation](#-installation) โ€ข [Quick Start](#-quick-start) โ€ข [Available Servers](#-available-servers) โ€ข [Supported MCP Clients](#-supported-mcp-clients)
## ๐Ÿš€ Quick Start ![MCP Manager Demo](docs/mcp-manager-demo.gif) ## ๐Ÿ› ๏ธ Available Commands | Command | Description | |---------|-------------| | `search ` | Search for available MCP servers matching the keyword | | `info ` | Display detailed information about a specific server | | `install [--client=claude-desktop\|cursor\|claude-code]` | Install an MCP server for a specific client | | `uninstall [--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 [--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: ```bash pip install mcp-manager ``` For developers: ```bash # 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: ```bash # 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: ```bash poetry run pytest ``` ## ๐Ÿค Contributing Contributions are welcome! Please feel free to submit a Pull Request.