@rog0x/mcp-docker-tools

mcp-docker-tools

基于 Model Context Protocol 构建的 AI Agent Docker 管理工具。

提供 5 种用于检查容器、镜像、Dockerfile 和 Compose 配置的工具，LLM 可通过 MCP 使用这些工具。

工具

工具	描述
docker_container_list	列出正在运行或所有容器，并显示状态、端口、镜像、创建时间及资源使用情况（CPU、内存、网络/块 I/O）
docker_image_list	列出 Docker 镜像，并显示大小、标签、创建日期和层数
docker_dockerfile_analyze	分析 Dockerfile 是否符合最佳实践：多阶段构建、非 root 用户、层缓存、镜像大小、安全性
docker_compose_analyze	分析 docker-compose.yml：服务、端口、卷、网络、健康检查、依赖项和改进建议
docker_container_logs	获取容器日志，支持尾部内容、关键词筛选、时间范围和时间戳

先决条件

• 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