Docker Compose MCP

Docker Compose MCP 是一个基于 Model Context Protocol（MCP）的工具，允许用户通过自然语言指令管理 Docker 容器。无论是部署简单的 Web 服务还是复杂的多容器应用，该工具都能显著简化操作流程，提升开发和运维效率。

核心功能

Docker Compose MCP 提供了多项核心功能，帮助用户更高效地管理 Docker 容器：

• 自然语言容器编排：用户只需输入自然语言指令，如“部署一个 WordPress 和 MySQL 组合”，系统将自动生成相应的 Docker Compose 配置并启动服务。
• 容器调试：支持实时查看运行中的容器状态和日志，便于快速排查问题。
• 持久化存储管理：通过 Docker 卷保存重要数据，确保即使容器被删除，数据也不会丢失。

安装方法

Docker Compose MCP 可通过多种方式安装，具体如下：

使用 Claude Desktop

对于 macOS 用户，配置文件路径为 ~/Library/Application Support/Claude/claude_desktop_config.json；对于 Windows 用户，配置文件路径为 %APPDATA%/Claude/claude_desktop_config.json。

通过 PyPi 和 uv 安装

若尚未安装 uv，请根据系统提示进行安装。安装完成后，将以下内容添加到 MCP 服务器配置文件中：

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

使用 Docker 安装

克隆仓库后，构建 Docker 镜像：

docker build -t mcp-server-docker .

然后将以下内容添加到 MCP 服务器配置文件中：

"mcpServers": {
  "mcp-server-docker": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-v",
      "/var/run/docker.sock:/var/run/docker.sock",
      "mcp-server-docker"
    ]
  }
}

使用方法

安装完成后，用户可以通过自然语言指令与 Docker Compose MCP 交互，例如：

启动服务

在终端中执行以下命令启动服务：

uvx mcp-server-docker

发送自然语言指令

例如，输入以下指令：

创建一个名为 myapp 的项目，并包含一个 Nginx 服务器。

系统将自动解析指令并执行相应的 Docker 操作。

使用示例

以下是两个典型使用场景：

部署 WordPress 博客

用户可以通过以下指令快速部署一个 WordPress 博客：

部署一个 WordPress 博客，并且让它可以通过外部访问。

系统将自动生成 WordPress 和 MySQL 的组合配置，并启动服务。

运行 MySQL 数据库

用户可以通过以下指令启动一个 MySQL 数据库实例：

启动一个 MySQL 数据库实例。

系统将自动创建并运行 MySQL 容器，并返回连接信息。

注意事项

在使用 Docker Compose MCP 时，需注意以下事项：

• 敏感数据保护：Docker 并非安全的沙盒环境，建议不要在公开环境中处理敏感数据。
• 容器审查：在部署前需仔细检查生成的容器，确保其安全性。
• 高级功能限制：出于安全考虑，MCP 服务器不支持 --privileged 或 --cap-add 等高风险选项。

通过以上方式，用户可以轻松管理 Docker 容器，享受自然语言交互带来的便捷体验。