Docker MCP

🚀 Docker MCP サービス

Docker MCP サービスは、Docker コンテナ内でコードを実行し、その結果を Claude などの言語モデル（LLM）に返すための強力なモデルコンテキストプロトコルサーバーです。このサービスは、隔離されたコード実行、多言語サポート、および様々なパッケージ管理ツールとの統合など、さまざまな機能をサポートしています。

✨ 主な機能

• 隔離されたコード実行：Docker コンテナを通じて、コードが独立した環境で実行されることを保証します。
• 多言語サポート：Python、Node.js など、複数のプログラミング言語をサポートします。
• 複雑なスクリプトサポート：複雑なスクリプトやタスクを処理することができます。
• パッケージ管理：pip、npm、apt - get、apk への組み込みサポートがあり、適切なパッケージ管理ツールを自動的に検出して使用します。
• コンテナ管理：Docker コンテナの作成、監視、およびクリーンアップ機能を提供します。
• 堅牢なエラー処理：タイムアウト検出と回復メカニズムを備え、タスクの確実な実行を保証します。
• カラー出力：ターミナルの色コードにより、ユーザー体験を向上させます。

📦 インストール

インストール要件

• Python バージョン：Python 3.6 以上がインストールされている必要があります。
• Docker のインストール：Docker が正しくインストールされ、実行されていることを確認してください（docker --version コマンドで確認できます）。
• fastmcp ライブラリ：LLM との統合をサポートするために、fastmcp ライブラリをインストールする必要があります。

インストール手順

1. コードリポジトリをクローンします：

   git clone https://github.com/your - repository.git
   

2. 仮想環境を作成し、アクティブ化します：

   python -m venv venv
   source venv/bin/activate  # Linux/Mac の場合
   venv\Scripts\activate     # Windows の場合
   

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

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

サーバーの起動

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

python src/docker_mcp.py

http://localhost:8090 にアクセスして、MCP がバインドされたコンソールを開きます。

ツールセット

コンテナの一覧表示

すべての実行中の Docker コンテナを表示します：

list_containers [--all]

• --all：停止しているコンテナを含むすべてのコンテナを表示します。

新しいコンテナの作成

新しい Docker コンテナを作成し、起動します：

create_container [-i IMAGE] [-- privileged|nonPrivileged] [COMMAND]

• IMAGE：イメージを指定します。デフォルトは python:3.8 - slim です。
• privileged または nonPrivileged：コンテナの権限モードを設定します。
• COMMAND：実行するコマンドを指定します。

コマンドの実行

既存のコンテナ内でコマンドを実行します：

execute_command [-c CONTAINER_ID] [-t COMMAND]

• CONTAINER_ID：対象のコンテナの ID を指定します。
• COMMAND：実行する具体的なコマンドです。

コンテナの削除

指定された Docker コンテナを削除します：

remove_container [-c CONTAINER_ID] [--volumes]

• CONTAINER_ID：削除するコンテナの ID を指定します。
• --volumes：コンテナに関連付けられたボリュームも同時に削除します。

高度な使用法

基本的なワークフロー

1. すべてのコンテナを一覧表示します：

   list_containers
   

2. Python コンテナを作成し、コマンドを実行します：

   create_container -i python:3.8 - slim -c "echo 'Hello, Docker!'" --nonPrivileged
   

3. 実行が完了したら、コンテナを削除します：

   remove_container [-c CONTAINER_ID]
   

Python データ分析の例

1. Node.js コンテナを作成し、依存関係をインストールします：

   create_container -i node:16 --privileged npm install express axios
   

2. スクリプトを実行します：

   execute_command [-c CONTAINER_ID] node script.js
   

📚 ドキュメント

パッケージマネージャーのサポート

サービスは適切なパッケージ管理ツールを自動的に検出して使用します：

• Python：pip を使用します。
• Node.js：npm を使用します。
• Debian/Ubuntu：apt - get を使用します。
• Alpine：apk を使用します。 イメージ名からパッケージマネージャーを推測できない場合は、利用可能なパッケージ管理ツールを検出しようとします。

LLM との統合

fastmcp ライブラリを通じて、Claude などの言語モデルとの統合をサポートし、より高度な機能拡張を実現します。

⚠️ 注意事項

• 権限問題：Docker コマンドを実行するには、管理者権限が必要な場合があります。
• リソース制限：コンテナの CPU およびメモリ使用量に注意し、システムリソースの過剰使用を避けてください。
• エラー処理：ネットワーク中断やイメージが見つからないなど、すべての可能性のある例外状況を処理するようにしてください。

🤝 貢献ガイド

プロジェクト開発への参加を歓迎します！詳細については、プロジェクトの貢献ガイドを参照してください。