What is Mcp Agg

MCP-Agg is a powerful API service that aggregates multiple tools and platforms, providing a unified interface for seamless integration and workflow automation.

Use cases

Use cases include automating workflows between GitHub and Slack, managing repositories and issues, posting messages in Slack channels, and retrieving user profiles across integrated services.

How to use

To use MCP-Agg, clone the repository, set up a virtual environment, install dependencies, configure the .env file, run database migrations, and start the application using Uvicorn.

Key features

Key features include a unified tool interface, secure authentication and authorization, an extensible architecture for adding new tools, MCP client support for unique URL generation, and comprehensive documentation with Swagger UI.

Where to use

MCP-Agg can be used in various fields such as software development, project management, and team collaboration, where integration of multiple platforms is essential.

MCP-Agg: Multi-Channel Platform Aggregator

MCP-Agg is a powerful API service that provides unified access to multiple tools and platforms through a single, consistent interface. It enables seamless integration with various services like GitHub, Slack, and more, simplifying workflow automation and enhancing productivity.

🚀 Features

• Unified Tool Interface: Access tools from multiple platforms through a standardized API
• Authentication & Authorization: Secure access to each integrated service
• Extensible Architecture: Easily add new tools and platforms
• MCP Client Support: Generate unique URLs for MCP client access
• Comprehensive Documentation: Well-documented API with Swagger UI

🛠️ Supported Platforms

GitHub

• List repositories
• Get repository details
• Manage issues and pull requests
• Access user profiles

Slack

• List channels
• Post messages
• Reply to threads
• Add reactions
• Access channel history
• Retrieve user profiles

📋 Requirements

• Python 3.12+
• PostgreSQL database
• uv package manager

🔧 Installation

1. Clone the repository:

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

2. Set up a virtual environment and install dependencies using uv:

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

3. Create a .env file based on the .env.example template:

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

4. Run database migrations:

alembic upgrade head

🚀 Running the Application

Development Mode

uvicorn api.main:app --reload --port 8000

Production Mode

uvicorn api.main:app --host 0.0.0.0 --port 8000

Using Docker

docker-compose up -d

📖 API Documentation

Once the application is running, access the interactive API documentation at:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

🔌 Using the MCP Client

To access all your tools through an MCP client:

1. Register and log in to the MCP-Agg service
2. Connect your accounts for each supported platform (GitHub, Slack, etc.)
3. Navigate to the MCP URL generator endpoint
4. Use the generated URL in your MCP client configuration

🧪 Testing

Run tests using pytest:

python -m pytest

For coverage information:

python -m pytest --cov=api

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

Project maintainer: moosh3

---

Built with ❤️ using FastAPI and Python