🐋 Docker MCP server

概述

Docker MCP 服务器让你能够使用自然语言管理 Docker 容器、镜像、网络和卷。

🏎️ 快速开始

前提条件

• 已安装 uv（参见安装文档）
• 克隆此仓库

配置 Claude Desktop

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

添加以下配置:

"mcpServers": {
  "mcp-server-docker": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo",
      "run",
      "mcp-server-docker"
    ]
  }
}

🚀 核心功能

• 使用自然语言组合和管理容器
• 检查和调试运行中的容器
• 管理持久化数据（Docker 卷）

📝 使用提示: docker_compose

使用自然语言创建和部署容器:

1. 提供项目名称和容器描述
2. 审核 LLM 生成的计划
3. 执行计划或提供反馈

示例:

• nginx: "部署一个 nginx 容器，暴露到 9000 端口"
• wordpress: "部署 WordPress 容器及其 MySQL 支持，暴露到 9000 端口"

⚠️ 安全注意事项

• 不要使用敏感数据（API 密钥、密码等）
• 仔细审核 LLM 创建的容器
• 此服务器不支持 --privileged 等敏感选项

📔 可用工具

容器

• list_containers, create_container, run_container
• start_container, stop_container, remove_container
• fetch_container_logs

镜像

• list_images, pull_image, push_image, build_image, remove_image

网络

• list_networks, create_network, remove_network

卷

• list_volumes, create_volume, remove_volume

🛠️ 配置与开发

• 使用 Python Docker SDK 的 from_env 方法
• 推荐使用 Devbox 配置开发环境
• 查看 devbox.json 获取开发命令