MCP Composer

🚀 MCP 統一マネージャー（Composer）

MCP 統一マネージャーは、すべての MCP サーバーを集中管理するゲートウェイサービスです。これを利用することで、必要なすべての MCP サーバーを統合し、各サービス（AI エージェントやツールなど）に対して異なるポートを独立して開き、サーバーとツールの異なる組み合わせを使用することができます。

✨ 主な機能

• 動的 MCP サーバー管理：複数の MCP サーバーとそのツールの接続を動的に管理し、サービスのリアルタイムな有効化または無効化を実現します。
• 統一 SSE インターフェース：すべての管理対象 MCP サーバーの機能にアクセスするための統一された Server-Sent Events (SSE) インターフェースを提供します。
• 複数の動的エンドポイントサポート：異なる AI エージェントまたは AI ツールに対応するため、複数の SSE エンドポイントの動的な作成と削除をサポートします。
• 独立したインターフェース構成：各 SSE インターフェースは独自の MCP サーバーとツールの組み合わせを独立して管理し、カスタマイズされたサービスの提供を実現します。

📚 ドキュメント

システムアーキテクチャ

主要用語

• MCP クライアント：Cursor、n8n などの外部ツールまたは AI エージェントおよび AI ワークフローです。
• ゲートウェイ[A/B]：ServerKit によって管理され、Composer によって制御される MCP サーバーの実装で、MCP クライアントの接続を処理します。
• サービススイート：下流の MCP サーバーの情報と、どのツールを有効にするかを管理および制御します。
• 下流コントローラー：下流の MCP サーバーとの接続を管理および制御します。
• 下流 MCP サーバー：内部オブジェクトで、下流の MCP サーバーに接続し、内部 MCP クライアントとして実装され、下流の MCP サーバーにリンクされます。
• MCP サーバー：https://github.com/modelcontextprotocol/servers などの外部 MCP サーバーサービスです。
• 統一マネージャー：ゲートウェイ、サービススイート、および下流コントローラーを制御および編成する API を提供します。

📦 インストール

要件

• Python >= 3.12
• uv：高速な Python パッケージインストーラーとマネージャーです。

手順

1. リポジトリをクローンする

   git clone https://github.com/htkuan/mcp-composer
   cd mcp-composer
   

2. 依存関係をインストールする uv を使用してプロジェクトの依存関係を同期します。

   make install
   # または直接 uv を使用する
   # uv sync
   

🔧 設定

アプリケーションを実行する前に、ターゲット MCP サーバーを設定する必要があります。

1. サンプル設定ファイルをコピーする

   cp mcp_servers.example.json mcp_servers.json
   

2. mcp_servers.json を編集し、接続する MCP サーバーの詳細情報を入力する

3. 環境変数を設定する

   cp .env.example .env
   

4. .env ファイルを編集して、以下の設定を行う

   • HOST：サーバーのホストアドレス（デフォルト: 0.0.0.0）
   • PORT：サーバーのポート（デフォルト: 8000）
   • MCP_COMPOSER_PROXY_URL：MCP 統一マネージャーのプロキシ URL（デフォルト: http://localhost:8000）
   • MCP_SERVERS_CONFIG_PATH：MCP サーバーの設定ファイルのパス（デフォルト: ./mcp_servers.json）

🚀 クイックスタート

uv を使用して FastAPI アプリケーションを実行します。

make run
# または直接 uv を使用する
# uv run src/main.py

サービスが起動した後、ブラウザを通じて API ドキュメントと対話することができます（通常は http://127.0.0.1:8000/docs）。

🔨 開発

プロジェクトには開発プロセスを簡素化するための Makefile が含まれています。

.PHONY: install lint test coverage

install:
    pip install -r requirements.dev.txt

lint:
    black --check .
    flake8 .

test:
    pytest

coverage:
    coverage run -m pytest && coverage report -f

make install を実行して開発用の依存関係をインストールし、make lint を使用してコードスタイルをチェックし、make test を使用してテストスイートを実行し、または make coverage を使用してカバレッジレポートを生成します。

🤝 コントリビューションガイド

プロジェクトに貢献するには、Contributing Guide を参照してください。

📄 ライセンス

このプロジェクトは LICENSE の条項の下で保護されています。