MCP-Agg: Multi-Channel Platform Aggregator

MCP-Agg：マルチチャネルプラットフォームアグリゲーター

MCP-Agg は、単一の一貫したインターフェースを通じて複数のツールやプラットフォームに統合的にアクセスできる、強力な API サービスです。GitHub や Slack などのさまざまなサービスとシームレスに連携できるため、ワークフローの自動化が簡素化され、生産性が向上します。

🚀 機能

• 統合ツールインターフェース：標準化された API を通じて複数のプラットフォームのツールにアクセスできます
• 認証と認可：連携する各サービスへの安全なアクセスを提供します
• 拡張可能なアーキテクチャ：新しいツールやプラットフォームを簡単に追加できます
• MCP クライアントのサポート：MCP クライアントからアクセスするための一意の URL を生成します
• 充実したドキュメント：Swagger UI による詳細な API ドキュメントを提供します

🛠️ 対応プラットフォーム

GitHub

• リポジトリの一覧表示
• リポジトリの詳細取得
• Issue とプルリクエストの管理
• ユーザープロフィールへのアクセス

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 ドキュメント

アプリケーションの起動後、次の URL からインタラクティブな API ドキュメントにアクセスできます：

• Swagger UI：https://localhost:8000/docs
• ReDoc：https://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

🤝 コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

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 ライセンスの下で公開されています。詳細については LICENSE ファイルをご覧ください。

📞 お問い合わせ

プロジェクトメンテナー：moosh3

---

FastAPI と Python を使用して ❤️ を込めて作成