MCP-Agg：多渠道平台聚合器

MCP-Agg 是一个强大的 API 服务，通过统一接口实现对多个工具和平台的集中访问。它简化了工作流自动化，并提升了工作效率，支持与 GitHub、Slack 等多种服务的无缝集成。

🚀 功能特点

• 统一工具接口：通过标准化 API 访问多个平台的工具
• 身份验证与授权：安全地访问每个集成的服务
• 可扩展架构：轻松添加新的工具和平台
• MCP 客户端支持：生成唯一的 MCP 客户端访问 URL
• 全面文档：配有 Swagger UI 的详细 API 文档

🛠️ 支持的平台

GitHub

• 列出仓库
• 获取仓库详情
• 管理问题和拉取请求
• 访问用户资料

Slack

• 列出频道
• 发布消息
• 回复线程
• 添加反应
• 访问频道历史记录
• 获取用户资料

📋 依赖项

• Python 3.12+
• PostgreSQL 数据库
• uv 包管理器

🔧 安装步骤

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 文档

启动应用后，访问交互式 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 文件。

📞 联系方式

若有任何问题，请联系开发者。