MCP Composer

🚀 MCP 统一管理器（Composer）

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

🚀 快速开始

需求

• 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）。

✨ 主要特性

• 动态 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 来控制和编排网关、服务套件及下游控制器。

📦 开发

项目包含一个 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 协议保护。

UI 演示