mirror of
https://github.com/samanhappy/mcphub.git
synced 2025-12-24 02:39:19 -05:00
142 lines
3.9 KiB
Markdown
142 lines
3.9 KiB
Markdown
# MCPHub: Your Ultimate MCP Server Hub
|
|
|
|
English | [中文版](README.zh.md)
|
|
|
|
MCPHub is a unified management platform that aggregates multiple MCP (Model Context Protocol) servers into separate SSE endpoints for different scenarios by group. It streamlines your AI tool integrations through an intuitive interface and robust protocol handling.
|
|
|
|
|
|
|
|
## 🚀 Features
|
|
|
|
- **Out-of-the-Box MCP Server Support**: Seamlessly integrate popular servers like `amap-maps`, `playwright`, `fetch`, `slack`, and more.
|
|
- **Centralized Dashboard**: Monitor real-time status and performance metrics from one sleek web UI.
|
|
- **Flexible Protocol Handling**: Full compatibility with both stdio and SSE MCP protocols.
|
|
- **Hot-Swappable Configuration**: Add, remove, or update MCP servers on the fly — no downtime required.
|
|
- **Group-Based Access Control**: Organize servers into customizable groups for streamlined permissions management.
|
|
- **Secure Authentication**: Built-in user management with role-based access powered by JWT and bcrypt.
|
|
- **Docker-Ready**: Deploy instantly with our containerized setup.
|
|
|
|
## 🔧 Quick Start
|
|
|
|
### Optional Configuration
|
|
|
|
Create a `mcp_settings.json` file to customize your server settings:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"amap-maps": {
|
|
"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
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
> **Note**: Default credentials are `admin` / `admin123`. Passwords are securely hashed with bcrypt. Generate a new hash with:
|
|
>
|
|
> ```bash
|
|
> npx bcryptjs your-password
|
|
> ```
|
|
|
|
### Docker Deployment
|
|
|
|
**Recommended**: Mount your custom config:
|
|
```bash
|
|
docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub
|
|
```
|
|
|
|
or run with default settings:
|
|
```bash
|
|
docker run -p 3000:3000 samanhappy/mcphub
|
|
```
|
|
|
|
### Access the Dashboard
|
|
|
|
Open `http://localhost:3000` and log in with your credentials.
|
|
> **Note**: Default credentials are `admin` / `admin123`.
|
|
|
|
**Dashboard Overview**:
|
|
- Live status of all MCP servers
|
|
- Enable/disable or reconfigure servers
|
|
- Group management for organizing servers
|
|
- User administration for access control
|
|
|
|
### SSE Endpoint
|
|
|
|
Connect AI clients (e.g., Claude Desktop, Cursor, Cherry Studio) via:
|
|
```
|
|
http://localhost:3000/sse
|
|
```
|
|
|
|
**Group-Specific Endpoints (Recommended)**:
|
|
|
|
|
|
|
|
For targeted access to specific server groups, use the group-based SSE endpoint:
|
|
```
|
|
http://localhost:3000/sse/{groupId}
|
|
```
|
|
|
|
Where `{groupId}` is the ID of the group you created in the dashboard. This allows you to:
|
|
- Connect to a specific subset of MCP servers organized by use case
|
|
- Isolate different AI tools to access only relevant servers
|
|
- Implement more granular access control for different environments or teams
|
|
|
|
## 🧑💻 Local Development
|
|
|
|
```bash
|
|
git clone https://github.com/samanhappy/mcphub.git
|
|
cd mcphub
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
This starts both frontend and backend in development mode with hot-reloading.
|
|
|
|
## 🔍 Tech Stack
|
|
|
|
- **Backend**: Node.js, Express, TypeScript
|
|
- **Frontend**: React, Vite, Tailwind CSS
|
|
- **Auth**: JWT & bcrypt
|
|
- **Protocol**: Model Context Protocol SDK
|
|
|
|
## 👥 Contributing
|
|
|
|
Contributions are welcome!
|
|
|
|
- New features & optimizations
|
|
- Documentation improvements
|
|
- Bug reports & fixes
|
|
- Translations & suggestions
|
|
|
|
## 📄 License
|
|
|
|
Licensed under the [Apache 2.0 License](LICENSE).
|