Central MCP Proxy

该项目通过Docker和Traefik搭建了一个集中式MCP服务器托管环境，整合了Notion、Linear、GitHub和Memory Bank等服务，使用SuperGateway实现通信协议转换。

开发者工具知识管理与记忆 #多服务整合 #协议转换 #容器化部署 #反向代理

评分 : 2分

下载量 : 9

更新时间 : 2025-04-28

什么是Model Context Protocol (MCP)?

MCP是一种用于连接不同工具和服务的协议，它允许您通过统一的接口访问多个平台的数据和功能。通过MCP服务器，您可以轻松地管理和操作GitHub、Notion、Linear等工具。

如何使用MCP服务器?

只需安装Docker和Docker Compose，然后按照简单的步骤启动服务即可。无需复杂的配置，即可快速开始使用。

适用场景

适合需要整合多个工具的工作流，例如项目管理、知识记录、任务跟踪等场景。

主要功能

多工具支持支持GitHub、Notion、Linear、Memory Bank等多种工具的集成。

高效的路径路由通过Traefik实现基于路径的请求分发，简化访问流程。

实时通信支持利用SuperGateway实现标准输入和SSE传输的无缝转换。

优势与局限性

优势

易于部署和使用

支持多种工具集成

强大的路径路由能力

局限性

需要安装Docker环境

某些工具可能需要特定API令牌

如何使用

克隆项目仓库

使用Git克隆此项目到本地。

配置环境变量

复制.env.example文件并填写必要的API令牌。

启动服务

使用Docker Compose启动所有服务。

使用案例

获取GitHub仓库信息通过GitHub MCP服务器查询特定仓库的信息。

记录项目笔记使用Memory Bank MCP服务器记录项目相关的学习笔记。

常见问题

如何解决路径路由问题？

MCP服务器无法启动怎么办？

🚀 中央 MCP 服务器主机

本项目借助 Docker、Traefik 和 SuperGateway，提供了一个集中式的托管环境，用于运行 Model Context Protocol (MCP) 服务器，能有效解决多 MCP 服务器管理和通信的问题，为用户提供便捷高效的使用体验。

🚀 快速开始

先决条件

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

设置步骤

克隆此仓库

复制 .env.example 文件到 .env 并填写你的 API 令牌：

cp .env.example .env
# 编辑 .env 文件并输入你的 API 令牌

启动服务：
```
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