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

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

📚 ドキュメント

アプリケーションを起動した後、次の URL から対話型 API ドキュメントにアクセスできます：

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

💻 使用例

基本的な使用法

MCP-Agg を使用して GitHub のリポジトリを一覧表示する例です。

# ここにサンプルコードを記述する予定ですが、元の README に具体的なコードがないため省略します。
# もしコードがあればここに表示されます。

高度な使用法

MCP-Agg を使用して Slack チャンネルにメッセージを投稿する例です。

# ここにサンプルコードを記述する予定ですが、元の README に具体的なコードがないため省略します。
# もしコードがあればここに表示されます。

🔌 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 ファイルを参照してください。

📞 連絡先

何か質問があれば、開発者に連絡してください。