https://github.com/ckreiling/mcp-server-docker
MCP server for Docker
https://github.com/ckreiling/mcp-server-docker
Last synced: about 1 month ago
JSON representation
MCP server for Docker
- Host: GitHub
- URL: https://github.com/ckreiling/mcp-server-docker
- Owner: ckreiling
- License: gpl-3.0
- Created: 2024-12-07T02:52:14.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-19T17:37:15.000Z (about 1 month ago)
- Last Synced: 2025-03-19T18:35:31.334Z (about 1 month ago)
- Language: Python
- Size: 65.4 KB
- Stars: 158
- Watchers: 6
- Forks: 19
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - Docker - <img src="./images/languages/python.svg" > Manage containers, images, volumes, and networks (Mcp Servers / integration)
- awesome-mcp - Docker - <img src="./images/languages/python.svg" > Manage containers, images, volumes, and networks (Mcp Servers / integration)
- awesome-mcp-servers - Docker - Manages and interacts with Docker containers using natural language (Table of Contents / System Automation)
- awesome-mcp-servers - Docker - Manages and interacts with Docker containers using natural language (Table of Contents / System Automation)
README
# đ Docker MCP server
An MCP server for managing Docker with natural language!
## đĒŠ What can it do?
- đ Compose containers with natural language
- đ Introspect & debug running containers
- đ Manage persistent data with Docker volumes
## â Who is this for?
- Server administrators: connect to remote Docker engines for e.g. managing a
public-facing website.
- Tinkerers: spin up containers locally, without running a single command
yourself.
## đī¸ Quickstart
### Install
#### Claude Desktop
On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
Install with `uv`
To install the MCP server using `uv`, run the following command:
```bash
uv pip install git+https://github.com/ckreiling/mcp-server-docker
```
And then add the following to your MCP servers file:
```
"mcpServers": {
"mcp-server-docker": {
"command": "uv",
"args": [
"--directory",
"/path/to/repo",
"run",
"mcp-server-docker"
]
}
}
```
Install with Docker
After cloning this repository, build the Docker image:
```bash
docker build -t mcp-server-docker .
```
And then add the following to your MCP servers file:
```
"mcpServers": {
"mcp-server-docker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/var/run/docker.sock:/var/run/docker.sock",
"mcp-server-docker:latest"
]
}
}
```
## đ Prompts
### đģ `docker_compose`
Use natural language to compose containers.
Provide a Project Name, and a description of desired containers, and let the LLM
do the rest.
This prompt instructs the LLM to enter a `plan+apply` loop. Your interaction
with the LLM will involve the following steps:
1. You give the LLM instructions for which containers to bring up
2. The LLM calculates a concise natural language plan and presents it to you
3. You either:
- Apply the plan
- Provide the LLM feedback, and the LLM recalculates the plan
#### Examples
- name: `nginx`, containers: "deploy an nginx container exposing it on port
9000"
- name: `wordpress`, containers: "deploy a WordPress container and a supporting
MySQL container, exposing Wordpress on port 9000"
#### Resuming a Project
When starting a new chat with this prompt, the LLM will receive the status of
any containers, volumes, and networks created with the given project `name`.
This is mainly useful for cleaning up, in-case you lose a chat that was
responsible for many containers.
## đ Resources
The server implements a couple resources for every container:
- Stats: CPU, memory, etc. for a container
- Logs: tail some logs from a container
## đ¨ Tools
### Containers
- `list_containers`
- `create_container`
- `run_container`
- `recreate_container`
- `start_container`
- `fetch_container_logs`
- `stop_container`
- `remove_container`
### Images
- `list_images`
- `pull_image`
- `push_image`
- `build_image`
- `remove_image`
### Networks
- `list_networks`
- `create_network`
- `remove_network`
### Volumes
- `list_volumes`
- `create_volume`
- `remove_volume`
## đ§ Disclaimers
### Sensitive Data
**DO NOT CONFIGURE CONTAINERS WITH SENSITIVE DATA.** This includes API keys,
database passwords, etc.
Any sensitive data exchanged with the LLM is inherently compromised, unless the
LLM is running on your local machine.
If you are interested in securely passing secrets to containers, file an issue
on this repository with your use-case.
### Reviewing Created Containers
Be careful to review the containers that the LLM creates. Docker is not a secure
sandbox, and therefore the MCP server can potentially impact the host machine
through Docker.
For safety reasons, this MCP server doesn't support sensitive Docker options
like `--privileged` or `--cap-add/--cap-drop`. If these features are of interest
to you, file an issue on this repository with your use-case.
## đ ī¸ Configuration
This server uses the Python Docker SDK's `from_env` method. For configuration
details, see
[the documentation](https://docker-py.readthedocs.io/en/stable/client.html#docker.client.from_env).
## đģ Development
Prefer using Devbox to configure your development environment.
See the `devbox.json` for helpful development commands.