mcp-hub

<div align="center"> <!-- 3D Logo Effect --> <h1> <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=800&size=48&pause=1000&color=10B981&center=true&vCenter=true&random=false&width=600&height=70&lines=MCP+HUB" alt="MCP HUB" /> </h1> <!-- Animated subtitle --> <p> <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=500&size=16&pause=500&color=94A3B8&center=true&vCenter=true&random=false&width=500&height=30&lines=The+homebrew+for+MCP+servers;Install+any+server+in+one+command;Auto-configures+Claude+%E2%80%A2+Cursor+%E2%80%A2+Cline+%E2%80%A2+Windsurf;26+CLI+commands+%E2%80%A2+34+servers+%E2%80%A2+24-page+docs" alt="Typing SVG" /> </p> <!-- Badges with animation --> <p> <a href="https://github.com/e2sy/mcp-hub/stargazers"><img src="https://img.shields.io/github/stars/e2sy/mcp-hub?style=for-the-badge&color=10b981&labelColor=1a1a1a" alt="Stars" /></a> <img src="https://img.shields.io/github/forks/e2sy/mcp-hub?style=for-the-badge&color=3b82f6&labelColor=1a1a1a" alt="Forks" /> <img src="https://img.shields.io/github/v/release/e2sy/mcp-hub?style=for-the-badge&color=amber&labelColor=1a1a1a" alt="Release" /> <img src="https://img.shields.io/github/license/e2sy/mcp-hub?style=for-the-badge&color=10b981&labelColor=1a1a1a" alt="License" /> </p> <p> <img src="https://img.shields.io/badge/Node.js-18%2B-10b981?style=for-the-badge&labelColor=1a1a1a" alt="Node.js" /> <img src="https://img.shields.io/badge/TypeScript-5.0-3178c6?style=for-the-badge&labelColor=1a1a1a" alt="TypeScript" /> <img src="https://img.shields.io/badge/Next.js-16-000000?style=for-the-badge&labelColor=1a1a1a" alt="Next.js" /> <img src="https://img.shields.io/github/actions/workflow/status/e2sy/mcp-hub/ci.yml?style=for-the-badge&label=CI&labelColor=1a1a1a" alt="CI" /> </p> <!-- Quick links with 3D card effect --> <p> <a href="#-quick-start"><img src="https://img.shields.io/badge/🚀_Quick_Start-10b981?style=for-the-badge&labelColor=1a1a1a" alt="Quick Start" height="28" /></a> <a href="#-cli-commands"><img src="https://img.shields.io/badge/💻_CLI_Commands-3b82f6?style=for-the-badge&labelColor=1a1a1a" alt="CLI" height="28" /></a> <a href="#-contributing--join-us"><img src="https://img.shields.io/badge/🤝_Contribute-amber?style=for-the-badge&labelColor=1a1a1a" alt="Contribute" height="28" /></a> <a href="#-roadmap"><img src="https://img.shields.io/badge/🗺️_Roadmap-purple?style=for-the-badge&labelColor=1a1a1a" alt="Roadmap" height="28" /></a> </p> <!-- Animated wave --> <img src="https://raw.githubusercontent.com/e2sy/mcp-hub/main/.github/assets/wave.svg" width="100%" alt="Wave" /> </div>

---

📊 Project Stats

<div align="center"> <a href="https://github.com/e2sy/mcp-hub/releases"><img src="https://img.shields.io/github/downloads/e2sy/mcp-hub/total?style=for-the-badge&color=10b981&labelColor=1a1a1a&label=Downloads" alt="Downloads" /></a> <a href="https://github.com/e2sy/mcp-hub/issues"><img src="https://img.shields.io/github/issues/e2sy/mcp-hub?style=for-the-badge&color=amber&labelColor=1a1a1a&label=Open+Issues" alt="Issues" /></a> <a href="https://github.com/e2sy/mcp-hub/pulls"><img src="https://img.shields.io/github/issues-pr/e2sy/mcp-hub?style=for-the-badge&color=3b82f6&labelColor=1a1a1a&label=Pull+Requests" alt="PRs" /></a> <a href="https://github.com/e2sy/mcp-hub/graphs/contributors"><img src="https://img.shields.io/github/contributors/e2sy/mcp-hub?style=for-the-badge&color=purple&labelColor=1a1a1a&label=Contributors" alt="Contributors" /></a> </div> <div align="center"> <a href="https://github.com/e2sy/mcp-hub"><img src="https://img.shields.io/github/repo-size/e2sy/mcp-hub?style=for-the-badge&color=10b981&labelColor=1a1a1a&label=Repo+Size" alt="Repo Size" /></a> <a href="https://github.com/e2sy/mcp-hub"><img src="https://img.shields.io/github/last-commit/e2sy/mcp-hub?style=for-the-badge&color=3b82f6&labelColor=1a1a1a&label=Last+Commit" alt="Last Commit" /></a> <a href="https://github.com/e2sy/mcp-hub"><img src="https://img.shields.io/github/commit-activity/m/e2sy/mcp-hub?style=for-the-badge&color=amber&labelColor=1a1a1a&label=Commits/Month" alt="Commit Activity" /></a> </div>

---

🚀 Quick Start

# Install any MCP server — no global install required
npx mcp-hub install github

# Or launch the interactive fuzzy finder
npx mcp-hub install

That's it. The CLI:

1. ✅ Auto-detects Claude Desktop, Cursor, Cline, and Windsurf on your machine
2. ✅ Backs up your existing config file
3. ✅ Writes the correct MCP server config to each client
4. ✅ Tells you exactly what it did

Restart your AI client and the server is live.

<details> <summary><b>📖 Why MCP Hub? (click to expand)</b></summary> <br/>

| Without MCP Hub | With MCP Hub | |:---:|:---:| | Search GitHub for an MCP server | mcp-hub search "postgres" | | Read the README to find the config | mcp-hub info postgres | | Find your client's config file path | Auto-detected | | Manually edit JSON, hope you don't break it | mcp-hub install postgres | | Repeat for each AI client you use | One command does all of them | | No backup if something goes wrong | .backup file created automatically | | No way to diagnose broken configs | mcp-hub doctor finds the issues | | Can't share your setup with teammates | mcp-hub bundle export | | Can't test if a server actually works | mcp-hub test <name> |

</details>

---

📸 Screenshots

<div align="center"> <table> <tr> <td align="center"><b>mcp-hub --help</b></td> <td align="center"><b>mcp-hub list</b></td> </tr> <tr> <td><img src=".github/assets/screenshots/help.png" alt="mcp-hub help" width="400" /></td> <td><img src=".github/assets/screenshots/list.png" alt="mcp-hub list" width="400" /></td> </tr> <tr> <td align="center"><b>mcp-hub status</b></td> <td align="center"><b>mcp-hub doctor</b></td> </tr> <tr> <td><img src=".github/assets/screenshots/status.png" alt="mcp-hub status" width="400" /></td> <td><img src=".github/assets/screenshots/doctor.png" alt="mcp-hub doctor" width="400" /></td> </tr> <tr> <td align="center"><b>mcp-hub history</b></td> <td align="center"><b>mcp-hub categories</b></td> </tr> <tr> <td><img src=".github/assets/screenshots/history.png" alt="mcp-hub history" width="400" /></td> <td><img src=".github/assets/screenshots/categories.png" alt="mcp-hub categories" width="400" /></td> </tr> </table> </div>

---

💻 CLI Commands

33 commands covering the full lifecycle: discover → install → diagnose → fix → monitor → update → share → publish

<details open> <summary><b>🔧 Core Commands</b></summary>

mcp-hub install [name]          # Install (interactive fuzzy finder if no name)
mcp-hub install <name> -c cursor # Install into a specific client only
mcp-hub list                    # List all available MCP servers
mcp-hub list --category database # Filter by category
mcp-hub list --featured         # Show only featured servers
mcp-hub list --interactive      # fzf-style browser
mcp-hub search "postgres"       # Search by name, tag, or description
mcp-hub info <name>             # Show detailed server info + config JSON
mcp-hub remove <name>           # Remove a server from all clients

</details> <details> <summary><b>🩺 Diagnostics & Monitoring</b></summary>

mcp-hub status                  # Dashboard — like git status for MCP
mcp-hub doctor                  # Diagnose config issues
mcp-hub doctor --fix            # Interactively fix issues
mcp-hub test <name>             # Spawn and verify a server responds
mcp-hub logs <name>             # Live log viewer (Ctrl+C to stop)
mcp-hub whoami                  # Show environment + detected clients
mcp-hub clients                 # Show detected AI clients + config paths
mcp-hub installed               # List what's currently installed

</details> <details> <summary><b>📦 Backup & Sharing</b></summary>

mcp-hub backup [--label <name>] # Back up all client config files
mcp-hub backup --list           # List available backups
mcp-hub backup --delete <name>  # Delete a backup
mcp-hub restore <name>          # Restore configs from a backup
mcp-hub bundle export <file>    # Export your setup as a portable JSON bundle
mcp-hub bundle install <file>   # Install all servers from a bundle

</details> <details> <summary><b>⚡ Updates, Scaffolding & Publishing</b></summary>

# Updates
mcp-hub outdated                # Check for CLI + server updates
mcp-hub upgrade                 # Upgrade the CLI to latest
mcp-hub upgrade --all           # Upgrade CLI + refresh all servers
mcp-hub update                  # Fetch the latest registry
mcp-hub update <name>           # Refresh one server's config
mcp-hub update --all            # Refresh all installed servers

# Scaffolding
mcp-hub init <name>             # Scaffold a new MCP server (TypeScript)
mcp-hub config show [client]    # Pretty-print config
mcp-hub config edit [client]    # Open config in $EDITOR
mcp-hub config-import           # Import existing configs from AI clients
mcp-hub alias add <alias> <srv> # Short name (e.g. gh → github)
mcp-hub alias list              # Show all aliases
mcp-hub add <github-url>        # Get config for a custom server
mcp-hub categories              # List all categories

# Publishing & Sharing
mcp-hub publish --category <c>  # Submit your server to the directory
mcp-hub history                 # Show your action log
mcp-hub history --clear         # Clear history
mcp-hub bundle-share share      # Share your setup via short ID
mcp-hub bundle-join <id>        # Install from a shared bundle
mcp-hub completions <shell>     # Generate bash/zsh/fish completions

</details>

---

🧠 AI Skills Marketplace

MCP Hub doesn't just install MCP servers — it also installs skill packs that make your AI assistant smarter at specific tasks.

29 built-in skills across 11 categories

| Category | Skills | Example | |----------|--------|---------| | Coding | 7 | Clean Code, Code Reviewer, TypeScript Expert, System Design, React Expert, Interview Prep | | Marketing | 3 | Growth Marketer, SEO Expert, Social Media Pro | | Security | 4 | Security Auditor, Pentester, Cloud Security, Compliance Officer | | Writing | 2 | Copywriter, Technical Writer | | Business | 3 | Startup Advisor, Product Manager, B2B Sales | | AI & ML | 2 | Prompt Engineer, RAG System Builder | | DevOps | 4 | Docker Pro, Kubernetes Expert, AWS Pro, CI/CD Pipelines | | Design | 1 | UI/UX Designer | | Data | 1 | SQL Expert | | Productivity | 1 | Productivity System (GTD) | | Languages | 1 | Language Tutor |

Add your own skills from GitHub

Found a skill pack on GitHub? Add it with one command:

# Add from any GitHub repo
mcp-hub skill add https://github.com/yaklang/hack-skills

# List your custom skills
mcp-hub skill list-custom

# Install to your AI clients
mcp-hub skill install hack-skills

# Update (re-fetch from GitHub)
mcp-hub skill update hack-skills

# Remove
mcp-hub skill remove-custom hack-skills

Any public GitHub repo with a markdown file works. MCP Hub:

1. Fetches the content from GitHub
2. Auto-detects name, category, and description
3. Saves it locally
4. Makes it available for install alongside built-in skills

Skill commands

mcp-hub skill list                    # browse all 29+ skills
mcp-hub skill list --category coding  # filter by category
mcp-hub skill list --installed        # show installed skills
mcp-hub skill install <name>          # install a skill
mcp-hub skill remove <name>           # remove a skill
mcp-hub skill search <query>          # search all skills
mcp-hub skill info <name>             # detailed info + preview
mcp-hub skill categories              # list all 11 categories
mcp-hub skill add <github-url>        # add custom skill from GitHub
m