返回 MCP 目录
public公开dns本地运行

Docker Compose

一个通过自然语言管理Docker的MCP服务器,支持容器编排、调试和数据管理。

article

README

🚀 🐋 Docker MCP 服务器

这是一个用于管理 Docker 的自然语言 MCP 服务器,借助自然语言交互,能让 Docker 容器的管理工作变得更加轻松高效。

🚀 快速开始

本服务器可助力用户通过自然语言便捷地管理 Docker 容器。下面为你介绍不同环境下的安装方式。

安装

使用 Claude Desktop

  • MacOS 系统:配置文件路径为 ~/Library/Application\ 支持/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 镜像:

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 卷的持久数据,保障数据安全。

❓ 适用人群

  • 服务器管理员:可连接到远程 Docker 引擎,例如管理公共面向互联网的网站。
  • 好奇心强的人:能在本地运行容器,并尝试开源应用程序对 Docker 的支持情况。
  • AI 爱好者:可以探索 LLM 的极限能力!

🎥 演示

以下是使用自然语言快速部署 WordPress 的示例: 示例链接

📝 提示信息

⚠️ 重要提示

  • 使用 docker ps 可列出所有运行的容器。
  • 使用 docker stop <container_id> 可停止指定容器。
  • 使用 docker rm <container_id> 可删除指定容器。

🛠️ 资源

该服务器运用了 Python Docker SDK 的 from_env 方法。有关配置详细信息,请参阅 文档

💻 开发

建议使用 Devbox 配置开发环境。查看 devbox.json 可获取有用的开发命令。

设置好 Devbox 后,可将 Claude MCP 配置为:

  "docker": {
    "command": "/path/to/repo/.devbox/nix/profile/default/bin/uv",
    "args": [
      "--directory",
      "/path/to/repo/",
      "run",
      "mcp-server-docker"
    ]
  },

🚨 注意事项

⚠️ 重要提示

  • 敏感数据:处理容器时需谨慎,Docker 并非安全的沙盒环境。MCP 服务器不支持 --privileged--cap-add/--cap-drop 等高风险选项。
  • 容器审查:在部署前需仔细检查生成的容器,确保其安全性。

通过以上步骤,你可以轻松使用 Docker MCP 服务器管理容器,享受自然语言交互带来的便利!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端