mcp-pm 0.1.0

Homebrew for MCP Servers — A CLI package manager for MCP servers

简体中文 | English

⛭ mcp-pm — Homebrew for MCP Servers

A CLI package manager for the Model Context Protocol ecosystem. Install, search, serve, and manage MCP servers with a single command.

Quick Start • Features • Commands • Architecture • Comparison • Registries

---

https://github.com/user-attachments/assets/placeholder

---

✨ Quick Start

# Install
pip install mcp-pm

# Search for MCP servers across 5 registries (Smithery, npm, PyPI, built-in...)
mcp search filesystem

# Install a server
mcp install mcp-server-filesystem

# List installed servers
mcp list

# Explore the Web UI dashboard
mcp explore

# Run a server in an isolated sandbox
mcp sandbox my-server --level docker

# Start an OpenAI-compatible HTTP proxy
mcp serve

No servers installed yet? Run mcp search database to discover servers from the community registry, or mcp explore to browse them visually.

---

🚀 Features

Feature	Description
🔍 Multi-Registry Search	Search across 5 registries simultaneously — Smithery (5,000+ servers), npm, PyPI, built-in curated list
📦 One-Command Install	mcp install <server> — installs from npm, pip, git, or Docker
🔒 Sandbox Isolation	Run untrusted servers in isolated environments (subprocess, Docker)
🌐 Web UI Dashboard	Beautiful dark-themed HTMX dashboard for visual management
⚡ OpenAI Proxy	Expose all installed MCP tools as an OpenAI-compatible API
🛡️ mcp doctor	Diagnostic tool that checks your entire MCP setup
🔧 12 Commands	Full lifecycle management — install, uninstall, update, list, search, info, explore, serve, sandbox, config, doctor, run
🌍 Multi-language UI	Web UI supports English and 中文 (Chinese), extensible to any language
📝 YAML Config	Human-readable configuration at ~/.mcp-pm/config.yaml
🎨 Beautiful CLI	Rich terminal output with tables, colors, and progress spinners

---

🎮 Commands

Command	Description	Example
mcp install	Install an MCP server	mcp install mcp-server-filesystem
mcp uninstall	Remove an installed server	mcp uninstall my-server
mcp update	Update all installed servers	mcp update
mcp list	List installed servers and tools	mcp list
mcp search	Search across all registries	mcp search database
mcp info	Show detailed server info	mcp info github
mcp explore	Launch the Web UI dashboard	mcp explore
mcp serve	Start HTTP proxy server	mcp serve
mcp sandbox	Run server in sandbox	mcp sandbox my-server --level docker
mcp config	Manage configuration	mcp config get servers
mcp doctor	Diagnose installation health	mcp doctor
mcp run	Run an MCP tool directly	mcp run my-server tool-name

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    User Interfaces                          │
│  ┌──────────┐  ┌────────────┐  ┌──────────┐  ┌──────────┐  │
│  │  CLI     │  │ Web UI     │  │ VS Code  │  │ CI/CD    │  │
│  │ Terminal │  │ Dashboard  │  │ Ext.     │  │ Actions  │  │
│  └────┬─────┘  └─────┬──────┘  └────┬─────┘  └────┬─────┘  │
└───────┼──────────────┼──────────────┼──────────────┼────────┘
        │              │              │              │
        ▼              ▼              ▼              ▼
┌─────────────────────────────────────────────────────────────┐
│                    CLI Core (click + rich)                   │
│  ┌─────────────────────────────────────────────────────────┐│
│  │    12 Subcommands: install · uninstall · list · search  ││
│  │    info · explore · serve · sandbox · config · update   ││
│  │    doctor · run                                          ││
│  └─────────────────────────────────────────────────────────┘│
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
│  │ Installer│  │ Config   │  │ Sandbox  │  │ HTTP Proxy  │ │
│  │ (multi-  │  │ (YAML)   │  │ (Docker  │  │ (OpenAI     │ │
│  │  source) │  │          │  │  isol.)  │  │  Compat.)   │ │
│  └──────────┘  └──────────┘  └──────────┘  └─────────────┘ │
└───────────────────┬─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────────────────────────┐
│                  Registry Integrations                       │
│  ┌────────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │ Smithery   │  │ npm      │  │ PyPI     │  │ Built-in │  │
│  │ 5,000+ srvs│  │ Registry │  │ Registry │  │ 27 srvs  │  │
│  └────────────┘  └──────────┘  └──────────┘  └──────────┘  │
└───────────────────┬─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────────────────────────┐
│                  Execution Environment                       │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────────┐  │
│  │ Subprocess   │  │ Docker       │  │ OpenAI API Proxy  │  │
│  │ Direct Spawn │  │ Sandbox      │  │ MCP → OpenAI     │  │
│  └──────────────┘  └──────────────┘  └───────────────────┘  │
└─────────────────────────────────────────────────────────────┘

---

📦 Registry Backends

mcp-pm aggregates servers from 5 registries simultaneously:

Registry	Status	Servers	Type
Built-in	✅ Always available	27 curated	Offline
Smithery (smithery.ai)	✅ Online	5,000+	API
npm (npmjs.com)	✅ Online	All mcp-server packages	API
PyPI (pypi.org)	✅ Online	All MCP Python packages	API
MCP.so	⚠️ Deprecated (API retired)	—	Graceful fallback
GitHub Registry	⚠️ Temporarily unavailable	—	Graceful fallback

All backends are queried in parallel with a 3-second timeout — you always get results fast.

---

🔄 Comparison

Feature	mcp-pm	MCP.so	Smithery	GitHub Registry
CLI-first	✅	❌	❌	❌
Offline mode (built-in index)	✅	❌	❌	❌
Sandbox isolation	✅	❌	❌	❌
Interactive TUI	✅	❌	❌	❌
Multi-registry search	✅	❌	❌	❌
Web UI dashboard	✅	✅	✅	✅
Auto-config generation	✅	❌	❌	❌
Open-source + self-hostable	✅	❌	❌	✅
OpenAI-compatible proxy	✅	❌	❌	❌
12 subcommands	✅	—	—	—

---

🛠️ Development

# Clone and set up
git clone https://github.com/weinotes/mcp-pm.git
cd mcp-pm
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,web]"

# Run tests
python -m pytest tests/ -v --tb=short

# Start Web UI
mcp explore

# Lint
ruff check .
ruff format --check .

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

• Bug reports: Open an issue
• Feature requests: Start a discussion
• Security issues: See SECURITY.md

---

📄 License

MIT License — Copyright (c) 2025-2026 Davey Wong [e-mail]

---

_{Made with ❤️ by Davey Wong}