local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables container and Docker Compose stack management, including creation of standalone containers, deployment of compose stacks, retrieval of container logs, and listing of container status and information.

🐳 docker-mcp

Docker 操作用の強力な Model Context Protocol (MCP) サーバー。Claude AI を通じてシームレスなコンテナーと Compose スタックの管理を可能にします。

✨ 特徴

🚀 コンテナの作成とインスタンス化
📦 Docker Compose スタックのデプロイメント
🔍 コンテナログの取得
📊 コンテナの一覧表示とステータス監視

🎬 デモ

Docker Composeスタックのデプロイ

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

コンテナログの分析

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

🚀 クイックスタート

Claude デスクトップアプリでこれを試すには、claude 構成ファイルに以下を追加します。

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Docker MCP を自動的にインストールするには:

npx @smithery/cli install docker-mcp --client claude

前提条件

UV（パッケージマネージャー）
Python 3.12以上
DockerデスクトップまたはDockerエンジン
クロードデスクトップ

インストール

クロードデスクトップ構成

Claude Desktop 構成ファイルにサーバー構成を追加します。

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

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-docker-mcp>",
        "run",
        "docker-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

🛠️ 開発

ローカルセットアップ

リポジトリをクローンします。

git clone https://github.com/QuantGeekDev/docker-mcp.git
cd docker-mcp

仮想環境を作成してアクティブ化します。

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

依存関係をインストールします:

uv sync

🔍 デバッグ

デバッグのために MCP Inspector を起動します。

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

インスペクターは、デバッグインターフェイスにアクセスするための URL を提供します。

📝 利用可能なツール

サーバーは次のツールを提供します。

コンテナの作成

スタンドアロンのDockerコンテナを作成する

{
    "image": "image-name",
    "name": "container-name",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "value"}
}

デプロイ-コンポーズ

Docker Composeスタックをデプロイする

{
    "project_name": "example-stack",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

ログを取得する

特定のコンテナからログを取得します

{
    "container_name": "my-container"
}

リストコンテナ

すべてのDockerコンテナを一覧表示します

{}

🚧 現在の制限

コンテナの組み込み環境変数サポートなし
ボリューム管理なし
ネットワーク管理なし
コンテナのヘルスチェックなし
コンテナ再起動ポリシーなし
コンテナリソースの制限なし

🤝 貢献する

docker-mcpからリポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを開く

📜 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

✨ 著者

Alex Andru -初期作業 | コア貢献者- @QuantGeekDev
Ali Sadykov -初期作業 | コア貢献者- @md-archive

❤️で作りました

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools