Docker MCP Plugin

用于Clawdbot的Docker MCP工具包

一个集成了Clawdbot的插件 提供全面的Docker容器管理、镜像操作和开发工作流功能。

特性

• 容器管理：列出、启动、停止、检查和管理Docker容器
• 图像操作：拉取、构建、标记和管理Docker镜像
• 卷和网络管理：创建和管理Docker卷和网络
• 撰写支持：使用Docker编写文件和服务
• MCP协议：利用模型上下文协议实现无缝集成
• 自动发现：自动发现并公开所有可用的Docker MCP工具

先决条件

• 安装时启用了MCP工具包
• 机器人 >= 2026.1.23
• 已配置Docker MCP工具包（随Docker桌面提供）

安装

来自npm（发布时）

clawdbot plugins install @clawdbot/docker-mcp

来源/存档

# Clone or download this repository
git clone https://github.com/clawdbot/docker-mcp-plugin.git

# Install the plugin
clawdbot plugins install ./docker-mcp-plugin

启用插件

clawdbot plugins enable docker-mcp

配置

添加到您的 clawdbot.json 配置：

{
  "plugins": {
    "entries": {
      "docker-mcp": {
        "enabled": true,
        "config": {
          "mcpCommand": "docker",
          "mcpArgs": ["mcp", "gateway", "run"],
          "enabledServers": [],
          "timeout": 30000,
          "debug": false
        }
      }
    }
  }
}

配置选项

用法示例

安装后，您可以在与Clawdbot的对话中自然地使用Docker操作：

容器管理

"List all running containers"
"Stop the container named my-app"
"Show logs for the nginx container"
"Start a new Ubuntu container"

图像操作

"Pull the latest node image"
"Build a Docker image from the current directory"
"List all local Docker images"
"Remove unused images"

Docker Compose

"Start the services defined in docker-compose.yml"
"Scale the web service to 3 instances"
"Show the status of all compose services"

开发工作流程

"Create a development environment with PostgreSQL and Redis"
"Set up a Docker network for microservices"
"Create a volume for persistent data"

📖 看 用法_示例.md 了解详细示例和工具调用格式。

可用工具

该插件会自动发现并公开所有Docker MCP Toolkit工具。常用工具包括：

• docker_container_list -列出容器
• docker_container_start -启动容器
• docker_container_stop -停止容器
• docker_container_logs -获取容器日志
• docker_image_list -列出图片
• docker_image_pull -拉取图像
• docker_image_build -塑造形象
• docker_compose_up -启动组合服务
• docker_compose_down -停止组合服务
• 还有更多。..

故障排除

插件未加载

1. 验证Docker Desktop是否已安装并正在运行
2. 检查Docker MCP工具包是否可用：

   docker mcp --help

1. 查看Clawdbot日志：

   clawdbot gateway logs

连接错误

• 确保Docker守护进程正在运行
• 检查MCP工具包的Docker桌面设置
• 验证没有防火墙阻止本地连接

未找到工具

• 跑 docker mcp catalog 查看可用服务器
• 检查 enabledServers 如果您正在筛选服务器，请配置
• 尝试设置 debug: true 在配置中查看发现日志

发展

从源代码构建

# Install dependencies
npm install

# Run tests (when available)
npm test

# Build (if using TypeScript compilation)
npm run build

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

麻省理工学院

链接

• 模型上下文协议
• Clawdbot文档
• 报告问题

学分

由Clawdbot社区创建。基于Docker Desktop的MCP工具包构建。