Docker MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides tools for managing Docker containers and images, including listing containers and images, running containers with customizable options, stopping and removing containers, and pulling images from registries.
Mentioned as an example image that can be pulled and run as a container with port mapping.
Docker MCP Server
A Model Context Protocol (MCP) server for Docker operations. This server allows Claude and other AI assistants to interact with Docker through the MCP protocol.
Note: This MCP server works with standard Docker CLI commands and does not currently support Docker Compose operations, other MCP servers with docker-compose didn't work reliably with cline yet.
Features
- List Docker containers
- List Docker images
- Run Docker containers
- Stop running containers
- Remove containers
- Pull Docker images from registries
Installation
Prerequisites
- Node.js 18 or higher
- Docker installed and running on your system
Install from npm
Install from source
- Clone this repository
- Install dependencies:
- Build the project:
Usage
Running the server
Or if installed from source:
Configuring with Claude
You can use the included installation script to automatically configure the Docker MCP server with Claude:
This script will:
- Detect your Claude installations (Desktop and/or VSCode)
- Update the configuration files to include the Docker MCP server
- Set up the correct paths for your system
Manual Configuration
If you prefer to configure manually, you need to add the Docker MCP server to your MCP settings configuration file:
For Claude Desktop App (macOS)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
For Claude in VSCode
Edit ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
Note: After configuring the Docker MCP server in VS Code, you may need to restart VS Code for the changes to take effect in Cline. If you encounter issues with the Docker MCP server not being recognized or working properly in Cline, try restarting VS Code.
Available Tools
list_containers
List all Docker containers.
Parameters:
all(boolean, optional): Show all containers (default shows just running)
list_images
List all Docker images.
run_container
Run a Docker container.
Parameters:
image(string, required): Docker image to runname(string, optional): Name for the containerdetach(boolean, optional): Run container in backgroundports(array of strings, optional): Port mappings (e.g. ["8080:80"])volumes(array of strings, optional): Volume mappings (e.g. ["/host/path:/container/path"])env(array of strings, optional): Environment variables (e.g. ["KEY=value"])command(string, optional): Command to run in the container
stop_container
Stop a running Docker container.
Parameters:
container(string, required): Container ID or name
remove_container
Remove a Docker container.
Parameters:
container(string, required): Container ID or nameforce(boolean, optional): Force removal of running container
pull_image
Pull a Docker image from a registry.
Parameters:
image(string, required): Image name (e.g. "nginx:latest")
Example Usage with Claude
Once configured, you can ask Claude to perform Docker operations:
- "Run a hello-world Docker container"
- "List all Docker containers"
- "Pull the latest nginx image"
- "Run an nginx container on port 8080"
- "Stop the nginx container"
- "Remove all stopped containers"
MCP Marketplace
This Docker MCP server is available on the Cline MCP Marketplace, making it easy for users to discover and install with one click.
The logo for the MCP Marketplace submission is located in the assets/logo.png file.
For more information about the MCP Marketplace, visit:
License
MIT
This server cannot be installed
Allows Claude and other AI assistants to interact with Docker through the MCP protocol, enabling container and image management including listing, running, stopping, and pulling Docker resources.