mirror of
https://github.com/samanhappy/mcphub.git
synced 2025-12-23 18:29:21 -05:00
120 lines
4.4 KiB
Markdown
120 lines
4.4 KiB
Markdown
# MCPHub: The Unified Hub for Model Context Protocol (MCP) Servers
|
|
|
|
English | [Français](README.fr.md) | [中文版](README.zh.md)
|
|
|
|
MCPHub makes it easy to manage and scale multiple MCP (Model Context Protocol) servers by organizing them into flexible Streamable HTTP (SSE) endpoints—supporting access to all servers, individual servers, or logical server groups.
|
|
|
|
|
|
|
|
## 🌐 Live Demo & Docs
|
|
|
|
- **Documentation**: [docs.mcphubx.com](https://docs.mcphubx.com/)
|
|
- **Demo Environment**: [demo.mcphubx.com](https://demo.mcphubx.com/)
|
|
|
|
## 🚀 Features
|
|
|
|
- **Centralized Management** - Monitor and control all MCP servers from a unified dashboard
|
|
- **Flexible Routing** - Access all servers, specific groups, or individual servers via HTTP/SSE
|
|
- **Smart Routing** - AI-powered tool discovery using vector semantic search ([Learn more](https://docs.mcphubx.com/features/smart-routing))
|
|
- **Hot-Swappable Config** - Add, remove, or update servers without downtime
|
|
- **OAuth 2.0 Support** - Both client and server modes for secure authentication ([Learn more](https://docs.mcphubx.com/features/oauth))
|
|
- **Database Mode** - Store configuration in PostgreSQL for production environments ([Learn more](https://docs.mcphubx.com/configuration/database-configuration))
|
|
- **Docker-Ready** - Deploy instantly with containerized setup
|
|
|
|
## 🔧 Quick Start
|
|
|
|
### Configuration
|
|
|
|
Create a `mcp_settings.json` file:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"time": {
|
|
"command": "npx",
|
|
"args": ["-y", "time-mcp"]
|
|
},
|
|
"fetch": {
|
|
"command": "uvx",
|
|
"args": ["mcp-server-fetch"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
📖 See [Configuration Guide](https://docs.mcphubx.com/configuration/mcp-settings) for full options including OAuth, environment variables, and more.
|
|
|
|
### Docker Deployment
|
|
|
|
```bash
|
|
# Run with custom config (recommended)
|
|
docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub
|
|
|
|
# Or run with default settings
|
|
docker run -p 3000:3000 samanhappy/mcphub
|
|
```
|
|
|
|
### Access Dashboard
|
|
|
|
Open `http://localhost:3000` and log in with default credentials: `admin` / `admin123`
|
|
|
|
### Connect AI Clients
|
|
|
|
Connect AI clients (Claude Desktop, Cursor, etc.) via:
|
|
|
|
```
|
|
http://localhost:3000/mcp # All servers
|
|
http://localhost:3000/mcp/{group} # Specific group
|
|
http://localhost:3000/mcp/{server} # Specific server
|
|
http://localhost:3000/mcp/$smart # Smart routing
|
|
```
|
|
|
|
📖 See [API Reference](https://docs.mcphubx.com/api-reference) for detailed endpoint documentation.
|
|
|
|
## 📚 Documentation
|
|
|
|
| Topic | Description |
|
|
| ------------------------------------------------------------------------------ | --------------------------------- |
|
|
| [Quick Start](https://docs.mcphubx.com/quickstart) | Get started in 5 minutes |
|
|
| [Configuration](https://docs.mcphubx.com/configuration/mcp-settings) | MCP server configuration options |
|
|
| [Database Mode](https://docs.mcphubx.com/configuration/database-configuration) | PostgreSQL setup for production |
|
|
| [OAuth](https://docs.mcphubx.com/features/oauth) | OAuth 2.0 client and server setup |
|
|
| [Smart Routing](https://docs.mcphubx.com/features/smart-routing) | AI-powered tool discovery |
|
|
| [Docker Setup](https://docs.mcphubx.com/configuration/docker-setup) | Docker deployment guide |
|
|
|
|
## 🧑💻 Local Development
|
|
|
|
```bash
|
|
git clone https://github.com/samanhappy/mcphub.git
|
|
cd mcphub
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
> For Windows users, start backend and frontend separately: `pnpm backend:dev`, `pnpm frontend:dev`
|
|
|
|
📖 See [Development Guide](https://docs.mcphubx.com/development) for detailed setup instructions.
|
|
|
|
## 🔍 Tech Stack
|
|
|
|
- **Backend**: Node.js, Express, TypeScript
|
|
- **Frontend**: React, Vite, Tailwind CSS
|
|
- **Auth**: JWT & bcrypt
|
|
- **Protocol**: Model Context Protocol SDK
|
|
|
|
## 👥 Contributing
|
|
|
|
Contributions welcome! See our [Discord community](https://discord.gg/qMKNsn5Q) for discussions and support.
|
|
|
|
## ❤️ Sponsor
|
|
|
|
[](https://ko-fi.com/samanhappy)
|
|
|
|
## 🌟 Star History
|
|
|
|
[](https://www.star-history.com/#samanhappy/mcphub&Date)
|
|
|
|
## 📄 License
|
|
|
|
Licensed under the [Apache 2.0 License](LICENSE).
|