Docker MCP 服务器

一个用于 Docker 操作的模型上下文协议 (MCP) 服务器。该服务器允许 Claude 和其他 AI 助手通过 MCP 协议与 Docker 交互。

注意： 此 MCP 服务器与标准 Docker CLI 命令配合使用，目前不支持 Docker Compose 操作。之前一些支持 docker-compose 的 MCP 服务器与 cline 的配合并不稳定。

功能

• 列出 Docker 容器
• 列出 Docker 镜像
• 运行 Docker 容器
• 停止运行中的容器
• 移除容器
• 从镜像仓库拉取 Docker 镜像

安装

前提条件

• Node.js 18 或更高版本
• Docker 已安装并在您的系统上运行

从 npm 安装

npm install -g docker-mcp-server

从源代码安装

1. 克隆此仓库
2. 安装依赖项：

cd docker-mcp
npm install

3. 构建项目：

npm run build

用法

运行服务器

docker-mcp-server

或者如果从源代码安装：

npm start

使用 Claude 进行配置

您可以使用包含的安装脚本自动配置 Docker MCP 服务器与 Claude：

npm run install-config

此脚本将：

1. 检测您的 Claude 安装（桌面版和/或 VSCode）
2. 更新配置文件以包含 Docker MCP 服务器
3. 为您的系统设置正确的路径

手动配置

如果您更喜欢手动配置，则需要将 Docker MCP 服务器添加到您的 MCP 设置配置文件中：

对于 Claude 桌面应用程序 (macOS)

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "docker-mcp": {
      "command": "node",
      "args": ["/path/to/docker-mcp/dist/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于 VSCode 中的 Claude

编辑 ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "docker-mcp": {
      "command": "node",
      "args": ["/path/to/docker-mcp/dist/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意： 在 VS Code 中配置 Docker MCP 服务器后，您可能需要重新启动 VS Code，以使更改在 Cline 中生效。 如果您遇到 Docker MCP 服务器无法在 Cline 中被识别或正常工作的问题，请尝试重新启动 VS Code。

可用工具

list_containers

列出所有 Docker 容器。

参数：

• all (布尔值，可选): 显示所有容器（默认仅显示正在运行的容器）

list_images

列出所有 Docker 镜像。

run_container

运行 Docker 容器。

参数：

• image (字符串，必需): 要运行的 Docker 镜像
• name (字符串，可选): 容器的名称
• detach (布尔值，可选): 在后台运行容器
• ports (字符串数组，可选): 端口映射（例如 ["8080:80"]）
• volumes (字符串数组，可选): 卷映射（例如 ["/host/path:/container/path"]）
• env (字符串数组，可选): 环境变量（例如 ["KEY=value"]）
• command (字符串，可选): 在容器中运行的命令

stop_container

停止正在运行的 Docker 容器。

参数：

• container (字符串，必需): 容器 ID 或名称

remove_container

移除 Docker 容器。

参数：

• container (字符串，必需): 容器 ID 或名称
• force (布尔值，可选): 强制移除正在运行的容器

pull_image

从镜像仓库拉取 Docker 镜像。

参数：

• image (字符串，必需): 镜像名称（例如 "nginx:latest"）

与 Claude 的示例用法

配置完成后，您可以要求 Claude 执行 Docker 操作：

• "运行一个 hello-world Docker 容器"
• "列出所有 Docker 容器"
• "拉取最新的 nginx 镜像"
• "在端口 8080 上运行一个 nginx 容器"
• "停止 nginx 容器"
• "移除所有已停止的容器"

MCP 应用商店

此 Docker MCP 服务器已在 Cline MCP 应用商店上架，方便用户一键发现和安装。

MCP 应用商店提交的徽标位于 assets/logo.png 文件中。

有关 MCP 应用商店的更多信息，请访问：

• MCP 应用商店仓库
• MCP 应用商店介绍

许可证

MIT