Container MCP

🚀 コンテナ化タスクプラットフォームドキュメント

このコンテナ化タスク実行プラットフォーム（MCP）は、ユーザーに安全で隔離され、拡張可能なタスク実行環境を提供することを目的としています。Dockerコンテナ技術を使用してタスクの隔離とリソース制御を実現し、サーバー送信イベント（SSE）プロトコルを通じてタスクの実行状態をリアルタイムで更新します。

🚀 クイックスタート

コンテナ化タスク実行プラットフォーム（MCP）をすぐに使い始めることができます。以下の手順に従って、環境をセットアップしてください。

✨ 主な機能

• タスク隔離：各タスクは独立したDockerコンテナで実行され、タスク間の相互干渉を防ぎます。
• リソース制限：CPU、メモリ、ディスク空間に対する制限をサポートし、リソースの乱用を防止します。
• タスク監視：タスクの実行状態をリアルタイムで更新し、異常なタスクを停止することができます。
• マルチテナント対応：設定により、異なるユーザーのリソース隔離と権限制御を実現します。

📦 インストール

迅速なインストール

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/yourusername/container-mcp.git
   cd container-mcp
   

2. Dockerをダウンロードしてインストールします：

   • Linuxシステムでは、公式スクリプトを使用してインストールします：

     curl -fsSL https://get.docker.com | bash -s docker
     

   • WindowsまたはmacOSでは、Docker公式サイトからダウンロードしてインストールします。

3. DockerGroupNameグループに参加して起動します（Linuxのみ）：

   sudo groupadd docker
   sudo usermod -aG docker $USER
   newgrp docker
   

4. プロジェクトコンテナを構築します：

   ./bin/02-build-container.sh
   

5. 実行環境を設定します：

   ./bin/03-setup-environment.sh
   

6. MCPサービスを起動します：

   ./bin/04-run-container.sh
   

詳細なインストール手順

1. プロジェクトを初期化します：

   ./bin/01-init.sh
   

2. コンテナイメージを構築します：

   ./bin/02-build-container.sh
   

3. 実行環境を設定します：

   ./bin/03-setup-environment.sh
   

4. MCPサービスを起動します：

   ./bin/04-run-container.sh
   

5. テストを実行します（オプション）：

   ./bin/05-run-tests.sh
   

💻 使用例

基本的な使用法

MCPサービスが起動したら、任意のMCPクライアントからこのサービスに接続できます。デフォルトでは、サービスはhttp://localhost:8000または設定ファイルで指定されたアドレスで実行されます。

from mcp.client.sse import sse_client
from mcp import ClientSession
import asyncio

async def main():
    # 接続先のMCPサービスのURLを設定します
    sse_url = "http://127.0.0.1:8000/sse"  # または他の設定されたポート
    
    # SSEクライアント接続を初期化します
    async with sse_client(sse_url) as client:
        # MCPセッションを作成します
        session = ClientSession(client)
        
        # タスクの実行状態の更新を取得します
        while True:
            update = await session.receive_update()
            print(f"更新を受信しました：{update}")

asyncio.run(main())

📚 ドキュメント

設定ガイド

MCPは環境変数を使用した設定をサポートしています。以下は一般的な設定項目です：

設定例

MCPサービスを実行する前に、環境変数を設定することでその動作を調整できます：

# デバッグモードを有効にし、イメージレジストリを指定します
export MCP_DEBUG=true
export DOCKER_REGISTRY=private-registry:8080
./bin/04-run-container.sh

開発ガイド

環境の準備

1. Python 3.8以上をインストールします：

   • Linuxではパッケージマネージャーを使用してインストールします：

     sudo apt-get install python3 python3-pip
     

   • WindowsとmacOSでは、Python公式サイトからダウンロードしてインストールします。

2. プロジェクトの依存関係をインストールします：

   pip install -r requirements.txt
   

コード構造

プロジェクトのコードは主に以下の部分で構成されています：

• container_mcp/: コンテナ化タスクの核心実装を含みます。
• mcp_client/: MCPサービスとのやり取りを行うクライアントインターフェースを提供します。
• tasks/: 実行可能なタスクスクリプトまたはバイナリファイルが格納されています。

開発フロー

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/yourusername/container-mcp.git
   cd container-mcp
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. 開発サーバーを起動します：

   python -m mcp.start_development_server
   

📄 ライセンス

このプロジェクトはMITライセンスに従っています。詳細なライセンス内容はLICENSE.mdファイルを参照してください。

作者情報

• 開発者：Your Name
• 連絡先メールアドレス：your.email@example.com
• GitHubリポジトリ：Container-MCP

Container-MCPをご利用いただき、ありがとうございます！ご質問やフィードバックがある場合は、いつでもお問い合わせください。