Mcphub: Deploy Your Own MCP Servers In Minutes

🚀 MCPHub：您的終極 MCP 服務器中樞

MCPHub 是一個統一管理平臺，它將多個 MCP（模型上下文協議）服務器整合到不同場景下的流式 HTTP（SSE）端點中，並按組分類。通過直觀的界面和強大的協議處理能力，MCPHub 極大地簡化了 AI 工具的集成過程。

🚀 快速開始

可選配置

您可以創建 mcp_settings.json 文件來自定義服務器設置：

{
  "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
    }
  ]
}

⚠️ 重要提示

默認憑據為 admin / admin123。密碼使用 bcrypt 安全哈希。若要生成新哈希，可使用以下命令：

npx bcryptjs your-password

Docker 部署

推薦方式：掛載自定義配置：

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

或者，您也可以使用默認設置運行：

docker run -p 3000:3000 samanhappy/mcphub

訪問控制檯

打開 http://localhost:3000 並登錄。

✨ 主要特性

• 開箱即用的 MCP 服務器支持：可無縫集成流行服務器，如 amap-maps、playwright、fetch、slack 等。
• 集中式控制檯：能從一個簡潔的網絡界面即時監控狀態和性能指標。
• 靈活的協議處理：全面兼容 stdio 和 SSE MCP 協議。
• 熱插拔配置：可隨時添加、刪除或更新 MCP 服務器，無需停機。
• 基於組的訪問控制：能將服務器組織到自定義組中，簡化權限管理。
• 安全認證：內置用戶管理，採用基於 JWT 和 bcrypt 的角色訪問控制。
• Docker 就緒：支持使用容器化立即部署。

🛠️ 常見問題

使用 Nginx 作為反向代理

如果您使用 Nginx 作為 MCPHub 的反向代理，請確保在您的 Nginx 配置中添加以下內容：

proxy_buffering off

🔧 技術細節

• 後端：採用 Node.js、Express、TypeScript 構建。
• 前端：使用 React、Vite、Tailwind CSS 開發。
• 認證：運用 JWT 和 bcrypt 進行身份驗證。
• 協議：使用模型上下文協議 SDK。

👥 貢獻

歡迎大家參與貢獻！具體可從以下方面入手：

• 新功能開發及優化
• 文檔改進
• 錯誤報告及修復
• 翻譯及建議

📄 許可證

本項目遵循 Apache 2.0 許可證。