AI导哈

Docker容器管理工具

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

  • by TGambit65
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 TGambit65/docker-mcp-plugin

使用说明

用于Clawdbot的Docker MCP工具包

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

特性

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

先决条件

  • Docker桌面 安装时启用了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
        }
      }
    }
  }
}

配置选项

选项 类型 默认值 描述
enabled 布尔值 true 启用/禁用插件
mcpCommand 字符串 "docker" docker命令的路径
mcpArgs string[] ["mcp", "gateway", "run"] docker mcp的参数
enabledServers string[] [] （all） 要启用的特定MCP服务器列表
timeout 编号 30000 MCP操作超时（毫秒）
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
  3. 查看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社区创建。基于Docker Desktop的MCP工具包构建。

相关 MCP