@rog0x/mcp-docker-tools

mcp-docker-tools

Model Context Protocolに基づいて構築された、AI エージェント向けの Docker 管理ツールです。

コンテナ、イメージ、Dockerfile、Compose 設定を調査する 5 つのツールを提供します。すべて MCP を通じて LLM から利用できます。

ツール

ツール	説明
docker_container_list	ステータス、ポート、イメージ、作成日時、リソース使用量（CPU、メモリ、ネットワーク／ブロック I/O）とともに、実行中またはすべてのコンテナを一覧表示します
docker_image_list	サイズ、タグ、作成日、レイヤー数とともに Docker イメージを一覧表示します
docker_dockerfile_analyze	マルチステージビルド、非 root ユーザー、レイヤーキャッシュ、イメージサイズ、セキュリティなど、ベストプラクティスに照らして Dockerfile を分析します
docker_compose_analyze	docker-compose.yml を分析します。サービス、ポート、ボリューム、ネットワーク、ヘルスチェック、依存関係、改善案を確認できます
docker_container_logs	tail、キーワードフィルター、時間範囲、タイムスタンプを指定してコンテナログを取得します

前提条件

• Node.js >= 18
• Docker CLI がインストールされ、PATH からアクセスできること
• Docker デーモンが実行中であること（コンテナ／イメージツールを使用する場合）

インストール

git clone <repo-url>
cd mcp-docker-tools
npm install
npm run build

Claude Desktop での使用方法

Claude Desktop の設定（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "docker-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
    }
  }
}

Claude Code での使用方法

claude mcp add docker-tools node D:/products/mcp-servers/mcp-docker-tools/dist/index.js

または、.claude/settings.json に追加します。

{
  "mcpServers": {
    "docker-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
    }
  }
}

ツールの使用例

実行中のコンテナを一覧表示する

{ "tool": "docker_container_list" }

停止中のコンテナを含め、すべてのコンテナを一覧表示する

{ "tool": "docker_container_list", "args": { "all": true, "format": "table" } }

名前でフィルターしてイメージを一覧表示する

{ "tool": "docker_image_list", "args": { "filter": "node" } }

Dockerfile を分析する

{
  "tool": "docker_dockerfile_analyze",
  "args": {
    "content": "FROM node:20\nCOPY . .\nRUN npm install\nCMD [\"node\", \"index.js\"]"
  }
}

docker-compose.yml を分析する

{
  "tool": "docker_compose_analyze",
  "args": {
    "content": "services:\n  web:\n    image: nginx\n    ports:\n      - 80:80"
  }
}

コンテナログを取得する

{
  "tool": "docker_container_logs",
  "args": { "container": "my-app", "tail": 50, "filter": "error" }
}

ライセンス

MIT