๐ The package manager for MCP servers โ like Homebrew for your AI toolchain
โโฆโโโโโโโ โโฆโโโโโโโโโโโโโโโโโฆโโ โโโโ โ โโโโโโโโโ โโฃโโโโ โโฃโ โฆโโฃ โ โฆโ โฉ โฉโโโโฉ โฉ โฉโฉ โฉโโโโฉ โฉโโโโโโโฉโโ
The package manager for MCP servers
Install, manage and run Model Context Protocol servers โ like Homebrew for your AI toolchain
What is this?
The Model Context Protocol (MCP) is an open standard for connecting AI models to external tools and data sources. GitHub Copilot, Claude Code, Cursor, and Windsurf all support MCP servers โ but there's no easy way to discover, install, and manage them.
mcp-manager fixes that. It's a single CLI that acts as a package manager for the entire MCP ecosystem. Think Homebrew, but for your AI toolchain.
Install any MCP server in seconds, keep them updated, and run them with a single command.
Demo
$ mcp install github
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Install Server โ
โ โ
โ Name โ GitHub MCP Server โ
โ Description โ Official GitHub MCP server for repository, โ
โ โ PR, issue management, code search, and โ
โ โ GitHub Actions workflows โ
โ Install Type โ go โ
โ Repository โ github.com/github/github-mcp-server โ
โ Version โ latest โ
โ Required Env โ GITHUB_TOKEN โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Install this server? [Y/n] y
โ Installing GitHub MCP Server...
โ Installing GitHub MCP Server...
โ Successfully installed GitHub MCP Server!
โ This server requires environment variables:
export GITHUB_TOKEN=<your-value>
$ mcp list
Installed MCP Servers
Name Version Status Install Path Installed At
โโโโโโ โโโโโโโ โโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ
github latest โ stopped ~/.mcp/servers/github 2026-03-19
1 server(s) installed
$ mcp search database
Search results for 'database'
Name Description Stars Type
โโโโ โโโโโโโโโโโ โโโโโ โโโโ
sqlite MCP server for querying and managing SQLite databases.. 12.5k npm
postgres MCP server for querying PostgreSQL databases with... 12.5k npm
2 result(s) found
$ mcp run github
โ Starting github (vlatest)
Press Ctrl+C to stop
Install
Homebrew (recommended)
brew install albertotijunelis/tap/mcp-manager
Note: This requires the Homebrew tap at albertotijunelis/homebrew-tap. The tap is auto-published by GoReleaser on each release.
curl one-liner
curl -sSfL https://raw.githubusercontent.com/albertotijunelis/mcp-manager/main/install.sh | sh
Go install
go install github.com/albertotijunelis/mcp-manager@latest
From source
git clone https://github.com/albertotijunelis/mcp-manager.git
cd mcp-manager
make build
./bin/mcp --help
Quick Start
Get a running MCP server in 60 seconds:
1. Check your system is ready
mcp doctor
2. Install an MCP server
mcp install github
3. Run it
export GITHUB_TOKEN=ghp_your_token_here
mcp run github
That's it. Your AI tools (Copilot, Claude, Cursor) can now connect to the GitHub MCP server.
Commands
| Command | Description | Example |
|---|---|---|
| mcp install <name> | Install an MCP server from the registry | mcp install github |
| mcp remove <name> | Remove an installed server and clean up | mcp remove github |
| mcp list | List all installed servers with status | mcp list |
| mcp run <name> | Launch an MCP server process | mcp run github |
| mcp search <query> | Search the server registry | mcp search database |
| mcp update [name] | Update servers or sync the registry | mcp update --all |
| mcp info <name> | Show detailed server information | mcp info github |
| mcp doctor | Check system dependencies and health | mcp doctor |
| mcp version | Print version information | mcp version |
Global flags
| Flag | Description |
|---|---|
| --no-color | Disable colored output |
| --debug | Enable debug logging |
| --json | Output in JSON format |
Registry
The registry is a curated JSON file containing metadata for all supported MCP servers. It ships with 20+ servers out of the box and is synced from the upstream repository.
Browse the full registry:
registry/registry.json
Sync the registry
mcp update
This fetches the latest server list from GitHub so you always have access to newly added servers.
Adding a Server
Want to add an MCP server to the registry? Edit registry/registry.json and open a PR!
Each server entry looks like this:
{
"name": "my-server",
"display_name": "My MCP Server",
"description": "A clear description of what this server does",
"repo": "github.com/owner/repo",
"install_type": "npm",
"binary": "my-mcp-server",
"package": "@scope/my-mcp-server",
"version": "latest",
"homepage": "https://github.com/owner/repo",
"topics": ["relevant", "tags"],
"requires_env": ["API_KEY"],
"stars": 100
}
Review criteria
- The server must implement the Model Context Protocol
- The repository must be public and actively maintained
- The description must be accurate and helpful
- The install type must be correct and tested
Supported Install Types
| Type | How it works | Example |
|---|---|---|
| go | Runs go install repo@version | GitHub MCP Server |
| npm | Runs npm install -g package | Filesystem, SQLite, Slack |
| pip | Runs pip install package | Python-based servers |
| git+build | Clones repo and runs build command | Custom servers |
| binary | Downloads pre-built binary from GitHub Releases | Platform-specific servers |
Built with Claude
This project was fully scaffolded and built with Claude by Anthropic โ including all Go source code, the registry, CI/CD pipelines, and this README.
The entire codebase was generated via a single structured prompt and then refined by the author. This is an example of what's possible when a developer uses Claude as a serious engineering co-pilot.
If you're curious about AI-assisted open source, feel free to open an issue or reach out.
Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
The easiest way to contribute is to add a new MCP server to the registry โ just edit registry/registry.json and open a PR.
License
MIT License โ see LICENSE for details.
Built with โค๏ธ by Alberto Tijunelis Neto ยท Powered by Bubble Tea