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 服务器管理容器,享受自然语言交互带来的便利!
扫码加入微信群