MCP-Agg: Multi-Channel Platform Aggregator

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

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

🚀 功能

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

🛠️ 支持的平台

GitHub

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

Slack

• 列出频道
• 发布消息
• 回复话题
• 添加表情回应
• 访问频道历史记录
• 获取用户资料

📋 要求

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

🔧 安装

1. 克隆仓库：

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

2. 使用 uv 创建虚拟环境并安装依赖：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

3. 根据 .env.example 模板创建 .env 文件：

cp .env.example .env
# Edit .env with your configuration settings

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. 在 MCP 客户端配置中使用生成的 URL

🧪 测试

使用 pytest 运行测试：

python -m pytest

查看覆盖率信息：

python -m pytest --cov=api

🤝 参与贡献

欢迎参与贡献！请随时提交 Pull Request。

1. 复刻仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

📝 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

📞 联系方式

项目维护者：moosh3

---

使用 FastAPI 和 Python 构建，倾注 ❤️