docker-mcp-server - 通过 Claude AI 管理 Docker 容器的 MCP 服务器

Posted on

docker-mcp 是一个强大的模型上下文协议（MCP）服务器，允许 Claude AI 无缝管理 Docker 容器和 Compose 堆栈。它提供容器创建、部署、日志检索和状态监控等核心功能，使 AI 能够通过自然语言与 Docker 生态系统交互。

工具列表

create-container

创建独立的 Docker 容器实例，支持自定义镜像、容器名称、端口映射和环境变量配置。这个工具让 AI 能够快速启动新容器而无需手动编写 Docker 命令。

参数：

  • image (string) (必需): 容器镜像名称，例如 ‘nginx:latest’ 或 ‘python:3.12’
  • name (string) (必需): 容器标识符，用于后续管理和引用
  • ports (object) (可选): 端口映射配置，键值对格式，例如 {‘80’: ‘80’, ‘443’: ‘443’}
  • environment (object) (可选): 环境变量配置，键值对格式，例如 {‘DB_HOST’: ‘localhost’, ‘DEBUG’: ‘true’}

deploy-compose

部署完整的 Docker Compose 堆栈，支持多容器应用的编排和管理。通过提供 YAML 格式的 Compose 配置文件，可以一次性启动整个服务栈。

参数：

  • project_name (string) (必需): Compose 堆栈的唯一标识符，用于管理和引用整个服务组
  • compose_yaml (string) (必需): 完整的 Docker Compose 配置内容，YAML 格式，定义服务、网络、卷等

get-logs

检索指定容器的输出日志，帮助调试和监控容器运行状态。支持实时查看容器的标准输出和标准错误输出。

参数：

  • container_name (string) (必需): 目标容器的标识符，与创建时指定的 name 参数对应

list-containers

枚举所有 Docker 容器及其状态信息，包括运行中、停止和退出的容器。提供容器的完整列表视图，方便全局管理。

参数：

配置示例

Claude Desktop

1
2
3
4
5
6
7
8
9
10
{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

Development

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "mcpServers": {
    "docker-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/docker-mcp",
        "run",
        "docker-mcp"
      ]
    }
  }
}

Smithery

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

使用场景

1. 开发环境快速搭建

通过 Claude AI 快速创建开发所需的各种容器服务，如数据库、缓存、消息队列等。只需告诉 AI ‘启动一个 PostgreSQL 数据库和 Redis 缓存’，AI 会自动创建并配置好容器，大幅降低环境搭建的时间成本。

2. 微服务应用部署

使用 deploy-compose 工具一键部署复杂的微服务架构。AI 可以根据项目需求生成完整的 docker-compose.yml 配置，并自动部署包含前端、后端、数据库、负载均衡器等多个服务的完整应用栈。

3. 容器故障诊断

当容器出现问题时，通过自然语言询问 AI ‘检查 web 容器的日志’，AI 会调用 get-logs 工具获取日志信息并进行分析，快速定位错误原因，提供修复建议，极大提升问题排查效率。

4. CI/CD 流程集成

在持续集成和部署流程中，AI 可以自动管理测试容器的生命周期，创建隔离的测试环境，运行自动化测试，收集测试结果，测试完成后清理容器，实现完全自动化的测试流程。

5. 容器资源监控

定期使用 list-containers 工具监控所有容器的运行状态，AI 可以识别异常停止的容器、资源占用过高的服务，并主动提供优化建议或执行自动重启等维护操作。

安装指南

前置要求

  • UV 包管理器
  • Python 3.12+
  • Docker Desktop 或 Docker Engine
  • Claude Desktop 应用程序

安装步骤

  1. 确保系统已安装 Docker 并正在运行
  2. 安装 UV 包管理器（如果尚未安装）
  3. 打开 Claude Desktop 配置文件：~/…/Claude/claude_desktop_config.json
  4. 添加 docker-mcp 服务器配置到 mcpServers 部分
  5. 重启 Claude Desktop 应用使配置生效
  6. 验证安装：在 Claude 中询问 ‘列出所有 Docker 容器’

项目信息

© 2026 Generative AI Discovery All Rights Reserved.
Theme by hiero