Mcphub: Deploy Your Own MCP Servers In Minutes

🚀 MCPHub: Your Ultimate MCP Server Hub

[English] | Chinese Version

MCPHub is a unified management platform that integrates multiple MCP (Model Context Protocol) servers into streaming HTTP (SSE) endpoints for different scenarios, categorized by groups. It simplifies the integration of your AI tools through an intuitive interface and powerful protocol processing capabilities.

✨ Features

• Out-of-the-box MCP Server Support: Seamlessly integrate popular servers such as amap-maps, playwright, fetch, slack, etc.
• Centralized Console: Monitor status and performance metrics in real-time from a sleek web interface.
• Flexible Protocol Handling: Fully compatible with stdio and SSE MCP protocols.
• Hot-swappable Configuration: Add, remove, or update MCP servers at any time without downtime.
• Group-based Access Control: Organize servers into custom groups to simplify permission management.
• Secure Authentication: Built-in user management with role-based access control based on JWT and bcrypt.
• Docker-ready: Deploy instantly using containerization.

🚀 Quick Start

Optional Configuration

Create a mcp_settings.json file to customize server settings:

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  },
  "users": [
    {
      "username": "admin",
      "password": "$2b$10$Vt7krIvjNgyN67LXqly0uOcTpN0LI55cYRbcKC71pUDAP0nJ7RPa.",
      "isAdmin": true
    }
  ]
}

⚠️ Important Note

The default credentials are admin / admin123. Passwords are securely hashed using bcrypt. To generate a new hash:

npx bcryptjs your-password

Docker Deployment

Recommended: Mount custom configuration:

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

Or run with default settings:

docker run -p 3000:3000 samanhappy/mcphub

Access the Console

Open http://localhost:3000 and log in.

🛠️ Frequently Asked Questions

Using Nginx as a Reverse Proxy

If you use Nginx as a reverse proxy for MCPHub, make sure to add the following to your Nginx configuration:

proxy_buffering off

🔧 Technical Details

• Backend: Node.js, Express, TypeScript
• Frontend: React, Vite, Tailwind CSS
• Authentication: JWT & bcrypt
• Protocol: Model Context Protocol SDK

👥 Contribution

Contributions are welcome!

• New features and optimizations
• Documentation improvements
• Bug reports and fixes
• Translations and suggestions

📄 License

This project is licensed under the Apache 2.0 License.