MCP Agg

🚀 MCP-Agg：多渠道平臺聚合器

MCP-Agg 是一個強大的 API 服務，它通過統一接口實現對多個工具和平臺的集中訪問。這一服務極大地簡化了工作流自動化，有效提升了工作效率，還支持與 GitHub、Slack 等多種服務進行無縫集成。

🚀 快速開始

MCP-Agg 提供了便捷的使用方式，你可以按照以下步驟快速開啟使用之旅。

安裝步驟

1. 克隆倉庫：

git clone https://github.com/moosh3/mcp-agg.git
cd mcp-agg

2. 創建虛擬環境並安裝依賴：

uv venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate
uv pip install -r requirements.txt

3. 基於 .env.example 模板創建一個 .env 文件：

cp .env.example .env
# 根據需要編輯 .env 文件中的配置信息

4. 執行數據庫遷移：

alembic upgrade head

運行應用

開發模式

uvicorn api.main:app --reload --port 8000

生產模式

uvicorn api.main:app --host 0.0.0.0 --port 8000

使用 Docker

docker-compose up -d

✨ 主要特性

• 統一工具接口：通過標準化 API 訪問多個平臺的工具。
• 身份驗證與授權：安全地訪問每個集成的服務。
• 可擴展架構：輕鬆添加新的工具和平臺。
• MCP 客戶端支持：生成唯一的 MCP 客戶端訪問 URL。
• 全面文檔：配有 Swagger UI 的詳細 API 文檔。

🛠️ 支持的平臺

GitHub

• 列出倉庫。
• 獲取倉庫詳情。
• 管理問題和拉取請求。
• 訪問用戶資料。

Slack

• 列出頻道。
• 發佈消息。
• 回覆線程。
• 添加反應。
• 訪問頻道歷史記錄。
• 獲取用戶資料。

📋 依賴項

• Python 3.12+
• PostgreSQL 數據庫
• uv 包管理器

💻 使用示例

基礎用法

MCP-Agg 的使用示例可以參考以下步驟，這裡以啟動應用為例：

# 開發模式
uvicorn api.main:app --reload --port 8000

# 生產模式
uvicorn api.main:app --host 0.0.0.0 --port 8000

# 使用 Docker
docker-compose up -d

📚 詳細文檔

啟動應用後，你可以訪問以下交互式 API 文檔：

• Swagger UI：http://localhost:8000/docs
• ReDoc：http://localhost:8000/redoc

🔌 使用 MCP 客戶端

通過 MCP 客戶端訪問所有工具：

1. 註冊並登錄到 MCP-Agg 服務。
2. 綁定各個支持平臺的賬戶（GitHub、Slack 等）。
3. 訪問 MCP URL 生成功能端點。
4. 將生成的 URL 配置到 MCP 客戶端中。

🧪 測試

使用 pytest 運行測試：

python -m pytest

獲取覆蓋率信息：

python -m pytest --cov=api

🤝 貢獻指南

歡迎貢獻！請隨意提交 Pull Request。

1. 叉倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m '添加一些很棒的功能'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 提交 Pull Request。

📄 許可證

本項目採用 MIT License，具體內容請參考 LICENSE 文件。

📞 聯繫方式

若有任何問題，請聯繫開發者。