📖 Documentation • 🎯 Examples • 💬 Discord • 🏢 Enterprise

🚀 Why MCP Hub?

The Problem: MCP (Model Context Protocol) is revolutionizing AI by letting LLMs use tools — but discovering and installing MCP servers is fragmented across GitHub, npm, and random blog posts.

The Solution: MCP Hub is the central registry for MCP servers. One command to search, install, and manage all your AI tools.

# Before: Hunt for servers, read docs, manually edit configs 😩
# After: One command ✨
mcphub install @official/github

⚡ Quick Start

# Install globally
npm install -g mcphub

# Search for servers
mcphub search github

# Install a server
mcphub install @official/github

# List installed servers
mcphub list

# Check your setup
mcphub doctor

That's it. MCP Hub automatically configures Claude Desktop for you.

✨ Features

| Feature | Description | |---------|-------------| | 🔍 Smart Search | Find servers by name, category, or keywords | | 📦 One-Click Install | Automatic Claude Desktop integration | | 🏷️ Categories | DevTools, Productivity, AI, Data, and more | | ✅ Verified Publishers | Trust official and community-verified servers | | 📊 Stats & Rankings | Downloads, stars, and popularity metrics | | 🔧 Config Management | Enable/disable servers without reinstalling | | 🩺 Doctor Command | Diagnose issues with your MCP setup | | 🎯 JSON Output | Scriptable with --json flag |

📦 Popular Servers

| Server | Description | Downloads | |--------|-------------|-----------| | @official/github | GitHub integration - repos, issues, PRs | 50K+ | | @official/filesystem | Secure file system access | 75K+ | | @official/puppeteer | Browser automation | 35K+ | | @official/postgres | PostgreSQL database access | 42K+ | | @official/slack | Slack workspace integration | 28K+ | | @community/notion | Notion workspace | 15K+ | | @community/linear | Linear issue tracking | 8K+ |

Browse all servers →

📖 Commands

Search & Discover

# Search by keyword
mcphub search github
mcphub search "file system"

# Filter by category
mcphub search --category devtools
mcphub search --category productivity

# Show only verified servers
mcphub search --verified

# List all categories
mcphub categories

Install & Manage

# Install a server
mcphub install @official/github

# Install without prompts
mcphub install @official/github --yes

# Uninstall a server
mcphub uninstall @official/github

# List installed servers
mcphub list
mcphub list --enabled

Enable & Disable

# Disable without uninstalling
mcphub disable @official/github

# Re-enable
mcphub enable @official/github

Info & Stats

# Detailed server info
mcphub info @official/github

# Hub statistics
mcphub stats

# Check your setup
mcphub doctor

Output Formats

# JSON output for scripting
mcphub search github --json
mcphub list --json
mcphub info @official/github --json

🏗️ How It Works

1. Registry — MCP Hub maintains a registry of MCP servers (built-in + GitHub discovery)
2. Install — Downloads config and sets up environment variables
3. Configure — Automatically updates your claude_desktop_config.json
4. Run — Claude Desktop loads the MCP server on startup

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   MCP Hub    │────▶│   Registry   │────▶│ Claude Config │
│    CLI       │     │   (GitHub)   │     │    .json      │
└──────────────┘     └──────────────┘     └──────────────┘
                                                  │
                                                  ▼
                                          ┌──────────────┐
                                          │    Claude    │
                                          │   Desktop    │
                                          └──────────────┘

🔧 Configuration

MCP Hub stores its config in ~/.mcphub/config.json:

{
  "servers": {
    "@official/github": {
      "name": "@official/github",
      "version": "1.0.0",
      "installedAt": "2024-12-20T10:00:00.000Z",
      "config": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": { "GITHUB_TOKEN": "ghp_xxx" }
      },
      "enabled": true
    }
  },
  "settings": {
    "registryUrl": "https://registry.mcphub.dev",
    "autoUpdate": true
  }
}

Environment Variables

Some servers require environment variables. MCP Hub will prompt you during installation:

$ mcphub install @official/github

  This server requires the following environment variables:

  GITHUB_TOKEN: ghp_xxxxxxxxxxxxx

Install @official/github? (Y/n) 

🛠️ Programmatic API

Use MCP Hub as a library in your Node.js projects:

import { Registry, Config, getRegistry, getConfig } from 'mcphub';

// Search for servers
const registry = getRegistry();
const servers = await registry.search({ 
  query: 'github',
  category: 'devtools',
  limit: 10 
});

// Install a server
const config = getConfig();
config.installServer({
  name: '@official/github',
  version: '1.0.0',
  installedAt: new Date().toISOString(),
  config: {
    command: 'npx',
    args: ['-y', '@modelcontextprotocol/server-github'],
    env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN }
  },
  enabled: true
});

// Update Claude Desktop config
Config.updateClaudeConfig(config.getInstalledServers());

🗂️ Categories

| Category | Emoji | Description | |----------|-------|-------------| | devtools | 🛠️ | Developer tools and utilities | | productivity | 📊 | Boost your workflow | | data | 📁 | Data processing and analysis | | ai | 🤖 | AI and machine learning | | communication | 💬 | Chat, email, messaging | | automation | ⚡ | Automate workflows | | security | 🔒 | Security and authentication | | cloud | ☁️ | Cloud services | | database | 🗄️ | Database tools |

🆚 Comparison

| Feature | MCP Hub | Manual Setup | Other Tools | |---------|---------|--------------|-------------| | Search servers | ✅ One command | ❌ Google | ❌ N/A | | Install | ✅ Automatic | ❌ Manual config | ⚠️ Partial | | Claude integration | ✅ Auto-update | ❌ Edit JSON | ❌ Manual | | Categories | ✅ Built-in | ❌ None | ❌ None | | Verified publishers | ✅ Yes | ❌ No | ❌ No | | Enable/disable | ✅ Toggle | ❌ Delete/re-add | ❌ N/A | | Doctor diagnostics | ✅ Yes | ❌ No | ❌ No |

💰 Pricing

| Feature | Free | Pro ($19/mo) | Enterprise | |---------|------|--------------|------------| | Search & Install | ✅ Unlimited | ✅ Unlimited | ✅ Unlimited | | Public servers | ✅ All | ✅ All | ✅ All | | Private servers | ❌ | ✅ Up to 10 | ✅ Unlimited | | Download analytics | ❌ | ✅ | ✅ | | Verified badge | ❌ | ✅ | ✅ | | Priority support | ❌ | ✅ Email | ✅ Dedicated | | SSO/SAML | ❌ | ❌ | ✅ | | Self-hosted registry | ❌ | ❌ | ✅ | | SLA | ❌ | ❌ | ✅ 99.9% |

Contact us for Enterprise →

🤝 Contributing

We love contributions! See CONTRIBUTING.md for guidelines.

# Clone the repo
git clone https://github.com/DebuggingMax/mcphub.git
cd mcphub

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Link for local development
npm link

📣 Community

• 💬 Discord — Chat with us
• 🐦 Twitter — Updates and announcements
• 📝 Blog — Tutorials and news
• 🐛 Issues — Report bugs

🗺️ Roadmap

• [x] CLI with search, install, list
• [x] Claude Desktop integration
• [x] Categories and filters
• [ ] Web UI (browse.mcphub.dev)
• [ ] mcphub publish command
• [ ] Ratings and reviews
• [ ] Security scanning
• [ ] Self-hosted registry (Enterprise)

📜 License

MIT © DebuggingMax