MCP-Agg: 多通道平台聚合器

MCP-Agg 是一个强大的 API 服务，它通过一个单一、一致的接口提供对多个工具和平台的统一访问。它能够与 GitHub、Slack 等各种服务无缝集成，从而简化工作流程自动化并提高生产力。

🚀 功能特性

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

🛠️ 支持的平台

GitHub

• 列出仓库
• 获取仓库详情
• 管理 issue 和 pull request
• 访问用户个人资料

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

🧪 测试

使用 pytest 运行测试:

python -m pytest

获取覆盖率信息:

python -m pytest --cov=api

🤝 贡献

欢迎贡献! 请随时提交 Pull Request。

1. Fork 仓库
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 构建 ❤️