Central MCP Proxy

🚀 中央 MCP 服務器主機

本項目藉助 Docker、Traefik 和 SuperGateway，提供了一個集中式的託管環境，用於運行 Model Context Protocol (MCP) 服務器，能有效解決多 MCP 服務器管理和通信的問題，為用戶提供便捷高效的使用體驗。

🚀 快速開始

先決條件

• Docker 和 Docker Compose
• Notion API 令牌
• Linear API 令牌
• GitHub API 令牌

設置步驟

1. 克隆此倉庫
2. 複製 .env.example 文件到 .env 並填寫你的 API 令牌：

   cp .env.example .env
   # 編輯 .env 文件並輸入你的 API 令牌
   

3. 啟動服務：

   docker compose up -d
   

✨ 主要特性

• 此設置使用 Traefik 反向代理將請求路由到各種 MCP 服務器。
• SuperGateway 用於在 stdio 和 SSE 運輸之間進行轉換，允許 MCP 服務器與客戶端通過 SSE 通信。

📦 安裝指南

Docker Compose 結構

該項目使用模塊化 Docker Compose 結構：

• docker-compose.yml：包含 Traefik 配置的主要文件，並引用服務特定的文件
• docker-compose/github.yml：GitHub MCP 服務器配置
• docker-compose/notion.yml：Notion MCP 服務器配置
• docker-compose/memory-bank.yml：Memory Bank MCP 服務器配置
• docker-compose/linear.yml：Linear MCP 服務器配置

這種模塊化方法允許你：

• 啟動所有服務：docker compose up -d（使用默認的 all 配置文件）
• 使用配置文件啟動特定服務：
  • 只 GitHub：docker compose --profile github up -d
  • 只 Notion：docker compose --profile notion up -d
  • 只 Memory Bank：docker compose --profile memory-bank up -d
  • 只 Linear：docker compose --profile linear up -d
  • 明確啟動所有服務：docker compose --profile all up -d
• 輕鬆添加新服務，只需在 docker-compose 文件夾中創建一個新的文件

⚠️ 重要提示

• 該項目遵循現代 Docker Compose 實踐，通過省略 version 關鍵字（不再要求在 Docker Compose V2 及以上版本），實現現代化。
• 網絡配置僅定義在主要的 docker-compose.yml 文件中，以避免衝突。所有服務引用此網絡但不重新定義它。
• 默認配置文件設置為 all 在 .env 文件中使用 COMPOSE_PROFILES 環境變量，允許你運行 docker compose up 而無需顯式指定配置文件。

💻 使用示例

訪問服務

一旦運行，你可以通過每個工具的相應路徑路由訪問服務：

基於路徑的路由

• Traefik 儀表板：http://$HOSTNAME/dashboard/
• Notion MCP 服務器：
  • SSE 端點：http://$HOSTNAME/notion/sse
  • 消息端點：http://$HOSTNAME/notion/message
• GitHub MCP 服務器：
  • SSE 端點：http://$HOSTNAME/github/sse
  • 消息端點：http://$HOSTNAME/github/message
• Linear MCP 服務器：
  • SSE 端點：http://$HOSTNAME/linear/sse
  • 消息端點：http://$HOSTNAME/linear/message
• Memory-bank MCP 服務器：
  • SSE 端點：http://$HOSTNAME/memory-bank/sse
  • 消息端點：http://$HOSTNAME/memory-bank/message

🔧 技術細節

SuperGateway

SuperGateway 用於將 stdio 和 SSE 運輸之間轉換：

1. SuperGateway 安裝在容器中
2. 它運行 MCP 服務器命令並使用 --stdio 標誌
3. 它公開 HTTP 端點用於 SSE 連接和消息發送

Traefik 配置

Traefik 配置如下：

1. 根據路徑前綴路由請求（例如 /notion、/github）
2. 將流量反向代理到正確的服務
3. 使用 HTTPS 提供安全的通信通道

📚 詳細文檔

包含的 MCP 服務器

• Notion：與 Notion 數據庫和頁面交互
• Linear：與 Linear 票據交互
• GitHub：與 GitHub 倉庫、問題和拉取請求交互
• Memory Bank：用於記錄項目筆記、思想軌跡和學習的工具

附加信息

• 項目地址：https://github.com/nat-n/MCP-Server-Hub
• 問題報告：在此倉庫中提交問題或功能請求
• 貢獻指南：查看項目 README 以瞭解如何為該項目做出貢獻