MCP 统一管理器（Composer）

MCP 统一管理器是一款集中式管理所有 MCP 服务器的网关服务。您可以利用它来整合所需的全部 MCP 服务器，并为每个服务（如 AI 代理或工具）独立开启不同的端口，使用不同组合的服务器和工具。

关键特性

• 动态 MCP 服务器管理: 动态管理与多个 MCP 服务器及其工具的连接，实现实时激活或停用服务。
• 统一 SSE 接口: 提供一个统一的 Server-Sent Events (SSE) 接口，访问所有受管 MCP 服务器的功能。
• 多动态端点支持: 支持动态创建和移除多个 SSE 端点，以适应不同的 AI 代理或 AI 工具。
• 独立接口配置: 每个 SSE 接口独立管理其自身的 MCP 服务器和工具组合，实现定制化服务提供。

系统架构

关键术语

• MCP 客户端: 外部工具或 AI 代理及 AI 工作流，如 Cursor、n8n 等。
• 网关[A/B]: 由 ServerKit 管理且受 Composer 控制的 MCP 服务器实现，用于处理 MCP 客户端连接。
• 服务套件: 管理和控制下游 MCP 服务器的信息及其中哪些工具应启用。
• 下游控制器: 负责管理和控制与下游 MCP 服务器的连接。
• 下游 MCP 服务器: 内部对象，连接到下游 MCP 服务器，实现为内部 MCP 客户端，链接至下游 MCP 服务器。
• MCP 服务器: 外部 MCP 服务器服务，如：https://github.com/modelcontextprotocol/servers 等。
• 统一管理器: 提供 API 来控制和编排网关、服务套件及下游控制器。

需求

• Python >= 3.12
• uv: 一个快速的 Python 包安装程序和管理器。

安装

1. 克隆仓库:

   git clone https://github.com/htkuan/mcp-composer
   cd mcp-composer
   

2. 安装依赖项: 使用 uv 同步项目依赖。

   make install
   # 或直接使用 uv
   # uv sync
   

配置

在运行应用程序之前，需配置目标 MCP 服务器。

1. 复制示例配置文件:

   cp mcp_servers.example.json mcp_servers.json
   

2. 编辑 mcp_servers.json 并输入您要连接的 MCP 服务器详细信息。

3. 设置环境变量:

   cp .env.example .env
   

4. 编辑 .env 文件以配置以下设置:

   • HOST: 服务器主机地址（默认: 0.0.0.0）
   • PORT: 服务器端口（默认: 8000）
   • MCP_COMPOSER_PROXY_URL: MCP 统一管理器代理 URL（默认: http://localhost:8000）
   • MCP_SERVERS_CONFIG_PATH: MCP 服务器配置文件路径（默认: ./mcp_servers.json）

运行

使用 uv 运行 FastAPI 应用程序:

make run
# 或直接使用 uv
# uv run src/main.py

服务启动后，可通过浏览器访问 API 文档交互（通常为 http://127.0.0.1:8000/docs）。

开发

项目包含一个 Makefile 以简化开发流程:

.PHONY: install lint test coverage

install:
    pip install -r requirements.dev.txt

lint:
    black --check .
    flake8 .

test:
    pytest

coverage:
    coverage run -m pytest && coverage report -f

运行 make install 安装开发依赖，然后使用 make lint 检查代码风格，make test 运行测试 suite，或 make coverage 生成覆盖率报告。

贡献指南

要为项目做贡献，请参考 Contributing Guide。

许可证

此项目受 LICENSE 协议保护。