Docker MCP Toolkit for Clawdbot

A Clawdbot plugin that integrates Docker Desktop's MCP Toolkit to provide comprehensive Docker container management, image operations, and development workflow capabilities.

Features

• Container Management: List, start, stop, inspect, and manage Docker containers
• Image Operations: Pull, build, tag, and manage Docker images
• Volume & Network Management: Create and manage Docker volumes and networks
• Compose Support: Work with Docker Compose files and services
• MCP Protocol: Leverages the Model Context Protocol for seamless integration
• Auto-discovery: Automatically discovers and exposes all available Docker MCP tools

Prerequisites

• Docker Desktop installed with MCP Toolkit enabled
• Clawdbot >= 2026.1.23
• Docker MCP Toolkit configured (comes with Docker Desktop)

Installation

From npm (when published)

clawdbot plugins install @clawdbot/docker-mcp

From source/archive

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

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

Enable the plugin

clawdbot plugins enable docker-mcp

Configuration

Add to your clawdbot.json config:

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

Configuration Options

Option	Type	Default	Description
enabled	boolean	true	Enable/disable the plugin
mcpCommand	string	"docker"	Path to docker command
mcpArgs	string[]	["mcp", "gateway", "run"]	Arguments for docker mcp
enabledServers	string[]	[] (all)	List of specific MCP servers to enable
timeout	number	30000	Timeout in ms for MCP operations
debug	boolean	false	Enable debug logging

Usage Examples

Once installed, you can use Docker operations naturally in your conversations with Clawdbot:

Container Management

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

Image Operations

"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"

Development Workflows

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

📖 See USAGE_EXAMPLES.md for detailed examples and tool call formats.

Available Tools

The plugin automatically discovers and exposes all Docker MCP Toolkit tools. Common tools include:

• docker_container_list - List containers
• docker_container_start - Start a container
• docker_container_stop - Stop a container
• docker_container_logs - Get container logs
• docker_image_list - List images
• docker_image_pull - Pull an image
• docker_image_build - Build an image
• docker_compose_up - Start compose services
• docker_compose_down - Stop compose services
• And many more...

Troubleshooting

Plugin not loading

1. Verify Docker Desktop is installed and running
2. Check that Docker MCP Toolkit is available:

   docker mcp --help

3. Review Clawdbot logs:

   clawdbot gateway logs

Connection errors

• Ensure Docker daemon is running
• Check Docker Desktop settings for MCP Toolkit
• Verify no firewall blocking local connections

Tool not found

• Run docker mcp catalog to see available servers
• Check enabledServers config if you're filtering servers
• Try setting debug: true in config to see discovery logs

Development

Build from source

# Install dependencies
npm install

# Run tests (when available)
npm test

# Build (if using TypeScript compilation)
npm run build

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT

Links

• Docker MCP Toolkit Documentation
• Model Context Protocol
• Clawdbot Documentation
• Report Issues

Credits

Created by the Clawdbot community. Built on Docker Desktop's MCP Toolkit.