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 演示