Ckreiling MCP Server Docker

🐋 Docker MCP サーバー

自然言語によるコンソールプロセス (MCP) を用いた Docker 管理サーバーです！本サーバーは、自然言語を使って Docker コンテナの管理や操作を行うことができ、サーバー管理者や Docker 愛好者に最適です。

🚀 クイックスタート

前提条件

• uv がインストールされていることを確認してください（詳細は ドキュメント を参照）
• このリポジトリをクローンします

インストール

Claude Desktop

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "mcp-server-docker": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo",
      "run",
      "mcp-server-docker"
    ]
  }
}

✨ 主な機能

自然言語によるコンテナのオーケストレーション

• 🚀 自然言語を使ってコンテナをオーケストレートできます。例えば、「ポート 9000 で公開される nginx コンテナを起動して」といった指示を与えることができます。

実行中のコンテナのチェックとデバッグ

• 🔍 実行中のコンテナをチェックし、必要に応じてデバッグすることができます。

Docker ボリュームを使用した永続データの管理

• 📀 Docker ボリュームを使って永続データを管理できます。

❓ 対象ユーザー

サーバー管理者

• リモートの Docker エンジンに接続し、公共のウェブサイトなどを管理することができます。

愛好者

• ローカルでコンテナを起動する際に、コマンドを直接実行する必要がなくなります。

💻 使用例

基本的な使用法

# 自然言語によるコンテナのオーケストレーション
# 例: ポート 9000 で公開される nginx コンテナを起動する

高度な使用法

# 複数のコンテナを同時にオーケストレーションする
# 例: WordPress コンテナと MySQL コンテナを同時に起動し、WordPress をポート 9000 で公開する

📚 ドキュメント

🎻 docker_compose の使用方法

• 自然言語を使ってコンテナをオーケストレートします。
• プロジェクト名と必要なコンテナの説明を提供すると、大規模言語モデル (LLM) が残りの作業を行います。
• この指示により、LLM は plan+apply サイクルに入ります。LLM との対話には以下の手順が含まれます。
  1. 起動するコンテナを説明する指示を LLM に送信します。
  2. LLM が簡潔な自然言語の計画を計算し、あなたに提示します。
  3. あなたは以下のいずれかを選択できます。
     • 計画を適用する
     • LLM にフィードバックを提供し、LLM が計画を再計算する

例

• 名前: nginx，コンテナ: "ポート 9000 で公開される nginx コンテナをデプロイする"
• 名前: wordpress，コンテナ: "WordPress コンテナとサポートする MySQL コンテナをデプロイし、WordPress をポート 9000 で公開する"

プロジェクトの復元

• 新しいチャットを開始すると、LLM は指定された名前で作成されたすべてのコンテナ、ボリューム、ネットワークの状態を受け取ります。
• これは主に、多くのコンテナを管理しているチャットを失った場合のクリーンアップに使用されます。

📔 リソース

サーバーは各コンテナに対していくつかのリソースを実装しています。

• 統計情報: CPU、メモリなどのコンテナ情報
• ログ: コンテナのログ末尾を表示する

🔧 ツール

コンテナ

• list_containers
• create_container
• run_container
• recreate_container
• start_container
• fetch_container_logs
• stop_container
• remove_container

イメージ

• list_images
• pull_image
• push_image
• build_image
• remove_image

ネットワーク

• list_networks
• create_network
• delete_network
• connect_container_to_network
• disconnect_container_from_network

ボリューム

• list_volumes
• inspect_volume
• remove_volume

🚫 免責事項

本プロジェクトは、ユーザーが自然言語インターフェースを通じて Docker と対話するための実験的なツールを提供することを目的としています。本プロジェクトは本番環境での使用に適していない場合があり、機能は変更される可能性があります。

📋 注意事項

⚠️ 重要提示

• 使用する前に重要なデータをバックアップしてください。
• すべてのコマンドの潜在的な影響を理解してから使用してください。
• 公共のネットワークで使用する場合は注意してください。