Docker MCP工具

你是否曾经希望AI能够直接管理你的Docker容器和Compose堆栈，自动部署服务、查看日志、监控状态？今天要介绍的开源项目Docker MCP工具，正是为了实现这个目标而设计的。它提供了一个强大的MCP服务器，通过Claude AI实现容器和Compose堆栈的无缝管理。

项目基本信息

一、项目介绍

Docker MCP工具是一个让AI能够直接管理Docker容器的MCP服务器。它提供了四个核心工具，涵盖容器创建、Compose堆栈部署、日志获取和容器列表查看。

这个服务器提供了以下工具：

• create-container：创建独立Docker容器
• deploy-compose：部署Docker Compose堆栈
• get-logs：获取指定容器日志
• list-containers：列出所有Docker容器

二、核心优势

简单易用

工具参数设计直观，AI可以轻松理解和使用。

快速部署

通过uvx一键运行，无需安装。

Compose支持

支持部署Docker Compose堆栈，适合多容器应用。

日志查看

可以获取指定容器的日志，便于调试。

开源免费

MIT许可证，可自由使用和修改。

三、适用场景

AI辅助容器管理

让AI帮你创建容器、部署Compose堆栈、查看日志。

开发环境自动化

AI可以自动搭建开发所需的容器环境。

服务监控

AI可以定期查看容器状态和日志。

快速原型验证

通过AI快速部署测试环境。

四、安装教程

系统要求

安装步骤

第一步：配置Claude Desktop

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加配置：

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

第二步：通过Smithery安装（可选）

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

第三步：重启Claude Desktop

保存配置后，重启Claude Desktop。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来管理Docker了。

示例1：创建容器

用户指令：“创建一个名为my-nginx的Nginx容器，映射端口80到8080”

AI会调用create-container工具：

{
  "image": "nginx:latest",
  "name": "my-nginx",
  "ports": {"80": "8080"}
}

示例2：部署Compose堆栈

用户指令：“部署一个包含Web服务和数据库的Compose堆栈”

AI会调用deploy-compose工具：

{
  "project_name": "my-stack",
  "compose_yaml": "version: '3.8'\nservices:\n  web:\n    image: nginx:latest\n    ports:\n      - '8080:80'\n  db:\n    image: postgres:latest\n    environment:\n      POSTGRES_PASSWORD: secret"
}

示例3：查看容器日志

用户指令：“查看my-nginx容器的日志”

AI会调用get-logs工具：

{
  "container_name": "my-nginx"
}

示例4：列出所有容器

用户指令：“列出所有Docker容器”

AI会调用list-containers工具。

示例5：带环境变量的容器创建

{
  "image": "node:18",
  "name": "node-app",
  "ports": {"3000": "3000"},
  "environment": {"NODE_ENV": "production"}
}

六、当前限制

该项目目前存在以下限制：

• 容器不支持内置环境变量管理
• 无卷管理功能
• 无网络管理功能
• 无容器健康检查
• 无容器重启策略
• 无容器资源限制

七、常见问题

问题1：提示“Docker not found”

解决方案：确保Docker Desktop或Docker Engine已安装并运行。

问题2：权限不足

解决方案：将用户添加到docker组：sudo usermod -aG docker $USER，然后重新登录。

问题3：uvx命令找不到

解决方案：安装uv：pip install uv

问题4：Compose YAML格式错误

解决方案：确保YAML格式正确，使用有效的Docker Compose语法。

问题5：容器名称已存在

解决方案：使用不同的容器名称，或先删除现有容器。

八、总结

Docker MCP工具是一个简洁实用的MCP服务器，让AI能够通过Claude管理Docker容器和Compose堆栈。

这个项目的最大价值在于：

1. 简单易用：工具参数直观，易于理解
2. 快速部署：uvx一键运行
3. Compose支持：适合多容器应用部署
4. 日志查看：便于调试容器问题
5. MIT许可证：可自由使用和修改

如果你是Docker用户，并且希望用AI来辅助容器管理，Docker MCP工具是一个不错的选择。