多平台聚合API服务

MCP-Agg是一个强大的API服务,通过单一、一致的接口提供对多个工具和平台的统一访问,简化工作流程自动化并提高生产力。

  • by moosh3
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 moosh3/mcp-agg

使用说明

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
  1. 使用uv设置虚拟环境并安装依赖项:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
  1. 创建一个 .env 文件基于 .env.example 模板:
cp .env.example .env
# Edit .env with your configuration settings
  1. 运行数据库迁移:
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用户界面: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

🤝 贡献

欢迎投稿!请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

📝 许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

📞 联系

项目维护人员: moosh3


内置于❤️ 使用FastAPI和Python