Back to Browse
Free
Server data from the Official MCP Registry
MCP server for Docker — containers, health checks, Compose, logs for AI agents
About
MCP server for Docker — containers, health checks, Compose, logs for AI agents
Security Report
4.8
Use Caution4.8High RiskThis Docker MCP server is well-structured with proper error handling, input validation via Zod schemas, and appropriate scoping of permissions to local Docker socket operations. The codebase demonstrates good security practices with no hardcoded credentials, no network exfiltration, and no dangerous patterns. Minor issues include broad exception handling and lack of explicit permission validation, but these are low-severity and do not materially impact security for this category of server. Supply chain analysis found 4 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 10 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Docker socket path (default: /var/run/docker.sock)
Environment variable: DOCKER_HOST
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-friendlygeorge-docker-mcp-server": {
"env": {
"DOCKER_HOST": "your-docker-host-here"
},
"args": [
"-y",
"@supernova123/docker-mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@supernova123/docker-mcp-server
The Docker MCP server designed for agents that need their containers to stay running.
Without this: Your agent deploys a container, it crashes at 3am, and nobody notices until the user complains. Compose stacks drift. Health checks are manual. Logs are scattered across terminals.
With this: Your agent checks health, watches for readiness, restarts crashed containers, and follows logs, all through a single MCP interface. Containers stay running because your agent knows how to keep them running.
Why This Server?
There are 11+ Docker MCP servers on npm. Most are stale, GPL-licensed, or only cover basic CRUD. This one is different:
| This server | ckreiling/mcp-server-docker | docker/hub-mcp | |
|---|---|---|---|
| License | MIT | GPL-3.0 | Apache-2.0 |
| Last updated | Active | Jun 2025 (stale) | Active |
| Health checks | ✅ HTTP/TCP/exec probes | ❌ | ❌ |
| Auto-restart | ✅ set_restart_policy | ❌ | ❌ |
| Compose lifecycle | ✅ up/down/ps/logs/restart | ❌ | ❌ |
| Log streaming | ✅ tail + timestamp filter | Basic | Basic |
| Agent positioning | ✅ Built for agents | Generic Docker | Registry API |
Quick Start
One command to run:
npx @supernova123/docker-mcp-server
Claude Desktop / Cursor / VS Code Config
Add to your MCP settings:
{
"mcpServers": {
"docker": {
"command": "npx",
"args": ["-y", "@supernova123/docker-mcp-server"]
}
}
}
Claude Code
claude mcp add docker -- npx -y @supernova123/docker-mcp-server
Tools
Container Lifecycle
| Tool | Description |
|---|---|
list_containers | List containers with filters (state, label, name) |
inspect_container | Get detailed container config and state |
start_container | Start a stopped container |
stop_container | Stop a running container |
restart_container | Restart a container |
remove_container | Remove a container (with force option) |
recreate_container | Stop, remove, and re-create a container with same config |
run_container | Create + start a container in one call |
Image Management
| Tool | Description |
|---|---|
list_images | List images with optional filters |
pull_image | Pull an image from a registry |
build_image | Build an image from a Dockerfile |
remove_image | Remove an image |
Docker Compose
| Tool | Description |
|---|---|
compose_up | Bring up a Compose stack |
compose_down | Tear down a Compose stack |
compose_ps | List service states |
compose_logs | Tail Compose service logs |
compose_restart | Restart Compose services |
Health & Self-Healing
| Tool | Description |
|---|---|
check_health | Run a health probe (HTTP, TCP, exec) |
watch_health | Poll health until healthy or timeout |
set_restart_policy | Change restart policy on a running container |
Logs & Observability
| Tool | Description |
|---|---|
stream_logs | Get container logs with tail/timestamp filtering |
container_stats | CPU, memory, network, block I/O snapshot |
Exec
| Tool | Description |
|---|---|
exec_in_container | Run a command inside a running container |
Networks & Volumes
| Tool | Description |
|---|---|
list_networks | List Docker networks |
list_volumes | List Docker volumes |
Requirements
- Node.js 18+
- Docker daemon running locally (or remote via DOCKER_HOST)
- Docker socket accessible at
/var/run/docker.sock
Security
- Read-only by default: all container and image tools read state; write operations (start/stop/remove) require explicit tool calls
- No API keys needed: connects to local Docker daemon via socket
- No network access: all operations are local Docker API calls
- MIT License: fully auditable
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Cloud & DevOps MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
500
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
68
Installs
10.0
Security
4.6
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
120.0K
Stars
24
Installs
6.0
Security
5.0
Local