中央 MCP 服务器主机

这个项目提供一个集中的托管环境，用于运行 Model Context Protocol (MCP) 服务器，使用 Docker、Traefik 和 SuperGateway。

概述

此设置使用 Traefik 反向代理将请求路由到各种 MCP 服务器。SuperGateway 用于在 stdio 和 SSE 运输之间进行转换，允许 MCP 服务器与客户端通过 SSE 通信。

包含的 MCP 服务器

• Notion：与 Notion 数据库和页面交互
• Linear：与 Linear 票据交互
• GitHub：与 GitHub 仓库、问题和拉取请求交互
• Memory Bank：用于记录项目笔记、思想轨迹和学习的工具

先决条件

• 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
   

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 提供安全的通信通道

附加信息

• 项目地址：https://github.com/nat-n/MCP-Server-Hub
• 问题报告：在此仓库中提交问题或功能请求
• 贡献指南：查看项目 README 以了解如何为该项目做出贡献