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
npm install -g docker-mcp-server
Install from source
- Clone this repository
- Install dependencies:
cd docker-mcp
npm install
- Build the project:
npm run build
Usage
Running the server
docker-mcp-server
Or if installed from source:
npm start
Configuring with Claude
You can use the included installation script to automatically configure the Docker MCP server with Claude:
npm run install-config
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:
{
"mcpServers": {
"docker-mcp": {
"command": "node",
"args": ["/path/to/docker-mcp/dist/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
For Claude in VSCode
Edit ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"docker-mcp": {
"command": "node",
"args": ["/path/to/docker-mcp/dist/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
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