🚀 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 文件。

📞 联系方式

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