{"id":26479488,"url":"https://github.com/ckreiling/mcp-server-docker","last_synced_at":"2025-12-14T16:47:08.715Z","repository":{"id":266926881,"uuid":"899787279","full_name":"ckreiling/mcp-server-docker","owner":"ckreiling","description":"MCP server for Docker","archived":false,"fork":false,"pushed_at":"2025-06-05T02:52:13.000Z","size":144,"stargazers_count":638,"open_issues_count":10,"forks_count":84,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-10-26T08:58:15.270Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ckreiling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-07T02:52:14.000Z","updated_at":"2025-10-23T07:24:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"45cfa8d4-a19e-474e-8c81-9273dc821649","html_url":"https://github.com/ckreiling/mcp-server-docker","commit_stats":null,"previous_names":["ckreiling/mcp-server-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ckreiling/mcp-server-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckreiling%2Fmcp-server-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckreiling%2Fmcp-server-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckreiling%2Fmcp-server-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckreiling%2Fmcp-server-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ckreiling","download_url":"https://codeload.github.com/ckreiling/mcp-server-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckreiling%2Fmcp-server-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27731577,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-14T02:00:11.348Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-20T01:55:20.116Z","updated_at":"2025-12-14T16:47:08.709Z","avatar_url":"https://github.com/ckreiling.png","language":"Python","readme":"# 🐋 Docker MCP server\n\nAn MCP server for managing Docker with natural language!\n\n## 🪩 What can it do?\n\n- 🚀 Compose containers with natural language\n- 🔍 Introspect \u0026 debug running containers\n- 📀 Manage persistent data with Docker volumes\n\n## ❓ Who is this for?\n\n- Server administrators: connect to remote Docker engines for e.g. managing a\n  public-facing website.\n- Tinkerers: run containers locally and experiment with open-source apps\n  supporting Docker.\n- AI enthusiasts: push the limits of that an LLM is capable of!\n\n## Demo\n\nA quick demo showing a WordPress deployment using natural language:\n\nhttps://github.com/user-attachments/assets/65e35e67-bce0-4449-af7e-9f4dd773b4b3\n\n## 🏎️ Quickstart\n\n### Install\n\n#### Claude Desktop\n\nOn MacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n\u003cdetails\u003e\n  \u003csummary\u003eInstall from PyPi with uv\u003c/summary\u003e\n\nIf you don't have `uv` installed, follow the installation instructions for your\nsystem:\n[link](https://docs.astral.sh/uv/getting-started/installation/#installation-methods)\n\nThen add the following to your MCP servers file:\n\n```\n\"mcpServers\": {\n  \"mcp-server-docker\": {\n    \"command\": \"uvx\",\n    \"args\": [\n      \"mcp-server-docker\"\n    ]\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eInstall with Docker\u003c/summary\u003e\n\nPurely for convenience, the server can run in a Docker container.\n\nAfter cloning this repository, build the Docker image:\n\n```bash\ndocker build -t mcp-server-docker .\n```\n\nAnd then add the following to your MCP servers file:\n\n```\n\"mcpServers\": {\n  \"mcp-server-docker\": {\n    \"command\": \"docker\",\n    \"args\": [\n      \"run\",\n      \"-i\",\n      \"--rm\",\n      \"-v\",\n      \"/var/run/docker.sock:/var/run/docker.sock\",\n      \"mcp-server-docker:latest\"\n    ]\n  }\n}\n```\n\nNote that we mount the Docker socket as a volume; this ensures the MCP server\ncan connect to and control the local Docker daemon.\n\n\u003c/details\u003e\n\n## 📝 Prompts\n\n### 🎻 `docker_compose`\n\nUse natural language to compose containers. [See above](#demo) for a demo.\n\nProvide a Project Name, and a description of desired containers, and let the LLM\ndo the rest.\n\nThis prompt instructs the LLM to enter a `plan+apply` loop. Your interaction\nwith the LLM will involve the following steps:\n\n1. You give the LLM instructions for which containers to bring up\n2. The LLM calculates a concise natural language plan and presents it to you\n3. You either:\n   - Apply the plan\n   - Provide the LLM feedback, and the LLM recalculates the plan\n\n#### Examples\n\n- name: `nginx`, containers: \"deploy an nginx container exposing it on port\n  9000\"\n- name: `wordpress`, containers: \"deploy a WordPress container and a supporting\n  MySQL container, exposing Wordpress on port 9000\"\n\n#### Resuming a Project\n\nWhen starting a new chat with this prompt, the LLM will receive the status of\nany containers, volumes, and networks created with the given project `name`.\n\nThis is mainly useful for cleaning up, in-case you lose a chat that was\nresponsible for many containers.\n\n## 📔 Resources\n\nThe server implements a couple resources for every container:\n\n- Stats: CPU, memory, etc. for a container\n- Logs: tail some logs from a container\n\n## 🔨 Tools\n\n### Containers\n\n- `list_containers`\n- `create_container`\n- `run_container`\n- `recreate_container`\n- `start_container`\n- `fetch_container_logs`\n- `stop_container`\n- `remove_container`\n\n### Images\n\n- `list_images`\n- `pull_image`\n- `push_image`\n- `build_image`\n- `remove_image`\n\n### Networks\n\n- `list_networks`\n- `create_network`\n- `remove_network`\n\n### Volumes\n\n- `list_volumes`\n- `create_volume`\n- `remove_volume`\n\n## 🚧 Disclaimers\n\n### Sensitive Data\n\n**DO NOT CONFIGURE CONTAINERS WITH SENSITIVE DATA.** This includes API keys,\ndatabase passwords, etc.\n\nAny sensitive data exchanged with the LLM is inherently compromised, unless the\nLLM is running on your local machine.\n\nIf you are interested in securely passing secrets to containers, file an issue\non this repository with your use-case.\n\n### Reviewing Created Containers\n\nBe careful to review the containers that the LLM creates. Docker is not a secure\nsandbox, and therefore the MCP server can potentially impact the host machine\nthrough Docker.\n\nFor safety reasons, this MCP server doesn't support sensitive Docker options\nlike `--privileged` or `--cap-add/--cap-drop`. If these features are of interest\nto you, file an issue on this repository with your use-case.\n\n## 🛠️ Configuration\n\nThis server uses the Python Docker SDK's `from_env` method. For configuration\ndetails, see\n[the documentation](https://docker-py.readthedocs.io/en/stable/client.html#docker.client.from_env).\n\n### Connect to Docker over SSH\n\nThis MCP server can connect to a remote Docker daemon over SSH.\n\nSimply set a `ssh://` host URL in the MCP server definition:\n\n```\n\"mcpServers\": {\n  \"mcp-server-docker\": {\n    \"command\": \"uvx\",\n    \"args\": [\n      \"mcp-server-docker\"\n    ],\n    \"env\": {\n      \"DOCKER_HOST\": \"ssh://myusername@myhost.example.com\"\n    }\n  }\n}\n```\n\n## 💻 Development\n\nPrefer using Devbox to configure your development environment.\n\nSee the `devbox.json` for helpful development commands.\n\nAfter setting up devbox you can configure your Claude MCP config to use it:\n\n```\n  \"docker\": {\n    \"command\": \"/path/to/repo/.devbox/nix/profile/default/bin/uv\",\n    \"args\": [\n      \"--directory\",\n      \"/path/to/repo/\",\n      \"run\",\n      \"mcp-server-docker\"\n    ]\n  },\n```\n","funding_links":[],"categories":["Developer Tools","Cloud \u0026 DevOps MCP Servers","📚 Projects (1974 total)","Mcp Servers","Community Servers","پیاده‌سازی‌های سرور","HarmonyOS","MCP Servers","Task and Project Management","Table of Contents","🐳 Kubernetes \u0026 Containers","🤖 AI/ML","📂 카테고리","🗂️ Extensions by Category"],"sub_categories":["CI/CD \u0026 DevOps","MCP Servers","integration","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","Windows Manager","Cloud \u0026 DevOps","How to Submit","System Automation","🛠️ Developer Tools","⚙️ Development Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fckreiling%2Fmcp-server-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fckreiling%2Fmcp-server-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fckreiling%2Fmcp-server-docker/lists"}