MCP Hub

📖 About

MCP Hub is a modern, beautiful, and powerful web application designed to simplify the discovery, configuration, and deployment of Model Context Protocol (MCP) servers for Claude Desktop.

With MCP Hub, you can:

• 🔍 Browse and discover popular MCP servers
• 🛒 Add servers to your "Config Cart" with one click
• 📦 Generate production-ready claude_desktop_config.json configurations
• 📜 Auto-generate installation scripts (Bash & PowerShell)
• ⚡ Get started in seconds — no manual configuration needed

✨ Features

🚀 Quick Start

Option 1: Run Locally

# Clone the repository
git clone https://github.com/yourusername/mcp-hub.git
cd mcp-hub

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Option 2: Use npx (No Installation)

npx mcp-hub

Note: This project is designed to be built and run locally. The npx command will be available once published to npm.

Option 3: Docker

docker build -t mcp-hub .
docker run -p 5173:5173 mcp-hub

Open your browser and navigate to http://localhost:5173

📖 Usage Guide

1. Browse Servers

Use the search bar and category filters to find MCP servers that match your needs.

2. Add to Cart

Toggle the switch on any server card to add it to your configuration. Selected servers are highlighted.

3. Generate Config

Click the Config Cart button in the header to open the configuration panel. You can:

• 📋 Copy the JSON configuration
• ⬇️ Download claude_desktop_config.json
• 🐚 Get installation scripts (Bash/PowerShell)

4. Install

Manual Installation

Copy the generated JSON to your Claude Desktop config:

macOS/Linux:

mkdir -p ~/.config
cp claude_desktop_config.json ~/.config/claude_desktop_config.json

Windows:

mkdir $env:APPDATA\Claude
copy claude_desktop_config.json $env:APPDATA\Claude\claude_desktop_config.json

Auto Installation (Recommended)

Run the generated install script:

Bash (macOS/Linux/WSL):

chmod +x install-mcp.sh
./install-mcp.sh

PowerShell (Windows):

.\install-mcp.ps1

⚠️ Important: Restart Claude Desktop after applying the configuration.

🛠️ Tech Stack

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Adding New MCP Servers

To add a new MCP server, edit src/data/mcp-data.ts:

{
  id: "my-server",
  name: "My Server",
  description: "Description of what your server does",
  command: "npx",
  args: ["-y", "@mypackage/server-my-server"],
  category: "database", // database, filesystem, api, development, ai, communication, utilities, other
  tags: ["tag1", "tag2"],
  icon: "Database", // Any Lucide icon name
},

📝 License

This project is licensed under the MIT License — see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol by Anthropic
• shadcn/ui for the beautiful component library
• MCP Server Registry for inspiration