{"_id":"mcp-docker-server","_rev":"2-7c24278b62128bb227f78ae75c76085d","name":"mcp-docker-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"mcp-docker-server","version":"1.0.0","keywords":["mcp","mcp-server","model-context-protocol","docker","containers","devops","docker-compose","ai","llm","claude","cursor"],"author":{"name":"Ofer Shapira"},"license":"MIT","_id":"mcp-docker-server@1.0.0","maintainers":[{"name":"ofershap","email":"ofershap@gmail.com"}],"homepage":"https://github.com/ofershap/mcp-server-docker#readme","bugs":{"url":"https://github.com/ofershap/mcp-server-docker/issues"},"bin":{"mcp-docker-server":"dist/index.js"},"dist":{"shasum":"e11b947672730031b415ef6c3aad577c9a726768","tarball":"https://registry.npmjs.org/mcp-docker-server/-/mcp-docker-server-1.0.0.tgz","fileCount":5,"integrity":"sha512-8oqrekNiJgkH58FpYt1eymgPeJWgLP4kz32vDU4bo10ttTs5Kom7KScOJ6jyVicL74+xItawhhx70LbQ5PAvaA==","signatures":[{"sig":"MEQCIBM3N10R5LfMwt4sKs0lRn3fffo3cTU12MlGai0X9AjGAiAtPC/uCoivyse6Z/TIEIjgYky+2YVmJJw+w13XpfIoow==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33074},"type":"module","gitHead":"b0509ccdc69b33b0e60ebd502959d52f5393f2c1","scripts":{"lint":"eslint . && prettier --check .","test":"vitest run","build":"tsup","format":"prettier --write .","prepare":"husky","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"ofershap","email":"ofershap@gmail.com"},"repository":{"url":"git+https://github.com/ofershap/mcp-server-docker.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Docker — manage containers, images, volumes, and compose services from your IDE","directories":{},"lint-staged":{"*.{ts,tsx,js}":"eslint --fix","*.{json,md,yml,yaml}":"prettier --write"},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.25.0","dockerode":"^4.0.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","husky":"^9.0.0","eslint":"^9.0.0","vitest":"^3.2.0","prettier":"^3.0.0","@eslint/js":"^9.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","lint-staged":"^15.0.0","@types/dockerode":"^3.3.0","typescript-eslint":"^8.0.0","eslint-config-prettier":"^10.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-docker-server_1.0.0_1771564060893_0.2581991698986881","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-docker-server","mcpName":"io.github.ofershap/docker","version":"1.0.1","description":"MCP server for Docker — manage containers, images, volumes, and compose services from your IDE","type":"module","bin":{"mcp-docker-server":"dist/index.js"},"scripts":{"build":"tsup","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","lint":"eslint . && prettier --check .","format":"prettier --write .","prepare":"husky"},"keywords":["mcp","mcp-server","model-context-protocol","docker","containers","devops","docker-compose","ai","llm","claude","cursor"],"author":{"name":"Ofer Shapira"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ofershap/mcp-server-docker.git"},"bugs":{"url":"https://github.com/ofershap/mcp-server-docker/issues"},"homepage":"https://github.com/ofershap/mcp-server-docker#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","dockerode":"^4.0.0","zod":"^3.25.0"},"devDependencies":{"@eslint/js":"^9.0.0","@types/dockerode":"^3.3.0","@types/node":"^22.0.0","eslint":"^9.0.0","eslint-config-prettier":"^10.0.0","husky":"^9.0.0","lint-staged":"^15.0.0","prettier":"^3.0.0","tsup":"^8.0.0","typescript":"^5.7.0","typescript-eslint":"^8.0.0","vitest":"^3.2.0"},"lint-staged":{"*.{ts,tsx,js}":["eslint --fix","prettier --write"],"*.{json,md,yml,yaml}":["prettier --write"]},"_id":"mcp-docker-server@1.0.1","gitHead":"402bd779724172d20aa57d5fa1d175eb2b732b84","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-cPZaBo+Xv72Xa2vsqJMyKfgiXAVi5vXV4NgseHYTTPqwEIdMLypAmd6w8/K9XiZ2EqWzNcNsHLeaxYgkzuGVTQ==","shasum":"0d80b012b08c46a741c65a430f62f75e8997304e","tarball":"https://registry.npmjs.org/mcp-docker-server/-/mcp-docker-server-1.0.1.tgz","fileCount":5,"unpackedSize":33494,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCsN/su+BIWCWlxCARuJOZCqE1HGSXkxdM94zDDc8e1eQIhAPVFIXDpX5g/X/oHjOa1UnaCFz5lMm59ja7yDXr44JyK"}]},"_npmUser":{"name":"ofershap","email":"ofershap@gmail.com"},"directories":{},"maintainers":[{"name":"ofershap","email":"ofershap@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-docker-server_1.0.1_1773134197044_0.5882055461297211"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T05:07:40.829Z","modified":"2026-03-10T09:16:37.399Z","1.0.0":"2026-02-20T05:07:41.028Z","1.0.1":"2026-03-10T09:16:37.274Z"},"bugs":{"url":"https://github.com/ofershap/mcp-server-docker/issues"},"author":{"name":"Ofer Shapira"},"license":"MIT","homepage":"https://github.com/ofershap/mcp-server-docker#readme","keywords":["mcp","mcp-server","model-context-protocol","docker","containers","devops","docker-compose","ai","llm","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/ofershap/mcp-server-docker.git"},"description":"MCP server for Docker — manage containers, images, volumes, and compose services from your IDE","maintainers":[{"name":"ofershap","email":"ofershap@gmail.com"}],"readme":"# mcp-server-docker\n\n[](https://www.npmjs.com/package/mcp-docker-server)\n[](https://www.npmjs.com/package/mcp-docker-server)\n[](https://github.com/ofershap/mcp-server-docker/actions/workflows/ci.yml)\n[](https://www.typescriptlang.org/)\n[](https://opensource.org/licenses/MIT)\n\nControl Docker containers, images, and services from your AI coding assistant. List, start, stop, read logs, run commands inside containers, and check resource usage.\n\n```bash\nnpx mcp-docker-server\n```\n\n> Compatible with Claude Desktop, Cursor, VS Code Copilot, and any MCP-compatible client. No API keys needed. Connects to your local Docker socket automatically.\n\n\n\nDemo built with remotion-readme-kit\n\n## Why\n\nIf you work with Docker daily, you know the routine: switch to a terminal, type `docker ps`, scroll through logs, copy container IDs, restart services. It adds up. This MCP server lets your AI assistant handle those tasks for you while you stay focused on code. Ask it to check which containers are running, pull up logs from a failing service, or restart something that got stuck. It talks to Docker's API through the local socket, so there's nothing to configure and no credentials to manage.\n\n## Tools\n\n| Tool | What it does |\n| ------------------- | ------------------------------------------------------------------- |\n| `list_containers` | List running (or all) containers with status, ports, and image info |\n| `container_logs` | Get recent logs from a container |\n| `start_container` | Start a stopped container |\n| `stop_container` | Stop a running container |\n| `restart_container` | Restart a container |\n| `remove_container` | Remove a container (with optional force) |\n| `exec_command` | Execute a command inside a running container |\n| `container_stats` | Get live CPU, memory, and network stats |\n| `list_images` | List all Docker images on the host |\n| `remove_image` | Remove a Docker image |\n\n## Quick Start\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"docker\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-docker-server\"]\n }\n }\n}\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"docker\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-docker-server\"]\n }\n }\n}\n```\n\n### VS Code\n\nAdd to user settings or `.vscode/mcp.json`:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"docker\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-docker-server\"]\n }\n }\n }\n}\n```\n\n## Examples\n\n- \"List all running Docker containers\"\n- \"Show me the logs from the nginx container\"\n- \"Restart the api-server container\"\n- \"What's the CPU and memory usage of my postgres container?\"\n- \"Execute `ls -la /app` inside the web container\"\n- \"List all Docker images and their sizes\"\n- \"Stop all containers that are using the old image\"\n\n## Prerequisites\n\n- **Docker** must be running on your machine\n- The server connects to the Docker socket at `/var/run/docker.sock` (Linux/macOS) or the named pipe on Windows\n- No API keys or tokens required\n\n## Development\n\n```bash\ngit clone https://github.com/ofershap/mcp-server-docker.git\ncd mcp-server-docker\nnpm install\nnpm test\nnpm run build\n```\n\n## See also\n\nMore MCP servers and developer tools on my [portfolio](https://gitshow.dev/ofershap).\n\n## Author\n\n[](https://gitshow.dev/ofershap)\n\n[](https://linkedin.com/in/ofershap)\n[](https://github.com/ofershap)\n\n---\n\nREADME built with [README Builder](https://ofershap.github.io/readme-builder/)\n\n## License\n\nMIT © 2026 Ofer Shapira\n","readmeFilename":"README.md"}