Mcp Server Docker

mcp-server-docker

通过 AI 编码助手管理 Docker 容器、镜像和服务。列出、启动和停止容器，读取日志，在容器内运行命令，并检查资源使用情况。

npx mcp-docker-server

兼容 Claude Desktop、Cursor、VS Code Copilot 及任何兼容 MCP 的客户端。无需 API 密钥。自动连接到本地 Docker 套接字。

 

_{演示由 remotion-readme-kit 制作}

为什么使用

如果你每天都使用 Docker，就会熟悉这样的流程：切换到终端，输入 docker ps，翻看日志，复制容器 ID，重启服务。日积月累，这些操作会占用不少时间。这个 MCP 服务可以让 AI 助手代你处理这些任务，让你专注于代码。你可以让它检查哪些容器正在运行、调取故障服务的日志，或重启卡住的服务。它通过本地套接字与 Docker API 通信，因此无需配置，也无需管理凭据。

工具

工具	功能
list_containers	列出正在运行的容器（或所有容器），包括状态、端口和镜像信息
container_logs	获取容器的近期日志
start_container	启动已停止的容器
stop_container	停止正在运行的容器
restart_container	重启容器
remove_container	删除容器（可选强制删除）
exec_command	在正在运行的容器内执行命令
container_stats	获取实时 CPU、内存和网络统计信息
list_images	列出主机上的所有 Docker 镜像
remove_image	删除 Docker 镜像

快速开始

Cursor

添加到 .cursor/mcp.json：

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

Claude Desktop

添加到 claude_desktop_config.json：

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

VS Code

添加到用户设置或 .vscode/mcp.json：

{
  "mcp": {
    "servers": {
      "docker": {
        "command": "npx",
        "args": ["-y", "mcp-docker-server"]
      }
    }
  }
}

示例

• “列出所有正在运行的 Docker 容器”
• “显示 nginx 容器的日志”
• “重启 api-server 容器”
• “我的 postgres 容器的 CPU 和内存使用情况如何？”
• “在 web 容器内执行 ls -la /app”
• “列出所有 Docker 镜像及其大小”
• “停止所有正在使用旧镜像的容器”

前置条件

• Docker 必须在你的机器上运行
• 服务会连接到 Docker 套接字 /var/run/docker.sock（Linux/macOS）或 Windows 上的命名管道
• 无需 API 密钥或令牌

Agent 插件

此仓库是一个 Agent Plugins 1.0.0 软件包：plugin.json、可移植的 mcp.json 和 skills/ 与 MCP 服务一同提供。

对于 Cursor，克隆仓库并将其复制或符号链接到 ~/.cursor/plugins/local/mcp-server-docker，然后重新加载窗口。技能和 MCP 会显示在 Customize > Plugins 下。

上方的 Cursor 和 VS Code 安装按钮仍然有效：它们会添加与手动 JSON 配置相同的 npx -y mcp-docker-server stdio 服务。

常见问题

什么是 mcp-docker-server？

这是此 MCP 服务的 npm 软件包（仓库名称为 mcp-server-docker）。它通过本地 Docker 套接字与 Docker 通信，可列出容器、查看日志、执行命令和管理镜像。

我需要运行 Docker Desktop 吗？

需要。守护进程必须处于运行状态，并且 MCP 进程必须能够访问 docker.sock（或 Windows 命名管道）。

在生产环境的容器中使用安全吗？

请将停止、删除和重启视为破坏性操作。更改生产工作负载前，请先向用户确认。

我可以在 Cursor 中将其作为 Agent 插件安装吗？

可以。请使用 ~/.cursor/plugins/local/mcp-server-docker，以便加载捆绑的 docker-management 技能和 MCP 配置。

我需要 API 密钥吗？

不需要。只需本地 Docker 访问权限。

开发

git clone https://github.com/ofershap/mcp-server-docker.git
cd mcp-server-docker
npm install
npm test
npm run build

另请参阅

在我的作品集中查看更多 MCP 服务和开发者工具。

作者

---

_{README 使用 README Builder 构建}

许可证

MIT © 2026 Ofer Shapira