docker-k8s-mcp
MCP server for managing Docker and Kubernetes from Claude Desktop, Cursor, or any MCP-compatible client.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
MCP server for managing Docker and Kubernetes from Claude Desktop, Cursor, or any MCP-compatible client.
MCP server to manage Docker and Kubernetes through Claude
| Tool | Description |
|---|
list_containers | List running (or all) containers with status and ports |
get_container_logs | Fetch stdout/stderr logs for the last N minutes (up to 10 MB) |
get_container_stats | CPU %, memory, network I/O, block I/O snapshot |
restart_container | Restart with a 10-second grace period |
inspect_container | Image, ports, mounts, env vars (secrets redacted) |
All tool calls have a 30-second timeout (60 seconds for log fetching).
DOCKER_HOST)go build -o docker-k8s-mcp .
Move to a stable path:
mv docker-k8s-mcp /usr/local/bin/docker-k8s-mcp
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"docker-k8s": {
"command": "/usr/local/bin/docker-k8s-mcp"
}
}
}
Restart Claude Desktop. A hammer icon will appear at the bottom of the chat window. Click it to confirm the 10 tools are listed.
Edit ~/.cursor/mcp.json (create if missing):
{
"mcpServers": {
"docker-k8s": {
"command": "/usr/local/bin/docker-k8s-mcp"
}
}
}
Edit .vscode/mcp.json in your workspace:
{
"servers": {
"docker-k8s": {
"type": "stdio",
"command": "/usr/local/bin/docker-k8s-mcp"
}
}
}
If Docker or Kubernetes is unavailable at startup, the server still starts. Tools for the unavailable backend will return an error message explaining what is missing.
To connect to a Docker daemon running on another machine, set DOCKER_HOST in the MCP config:
{
"mcpServers": {
"docker-k8s": {
"command": "/usr/local/bin/docker-k8s-mcp",
"env": {
"DOCKER_HOST": "tcp://192.168.1.10:2376",
"DOCKER_TLS_VERIFY": "1",
"DOCKER_CERT_PATH": "/Users/you/.docker/certs/my-server"
}
}
}
}
DOCKER_CERT_PATH should point to a directory containing ca.pem, cert.pem, and key.pem. These are the client certificates generated when you set up TLS on the remote daemon.
If TLS is not configured on the remote daemon (e.g. in a trusted internal network), use port 2375 and omit the TLS variables:
"DOCKER_HOST": "tcp://192.168.1.10:2375"
Via SSH tunnel (no certificates needed):
ssh -NL 2375:localhost:2375 user@remote-host
Then set DOCKER_HOST=tcp://localhost:2375.
FROM golang:1.23-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o docker-k8s-mcp .
FROM alpine:3.20
COPY --from=builder /app/docker-k8s-mcp /usr/local/bin/
CMD ["docker-k8s-mcp"]
docker run --rm -i \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.kube:/root/.kube:ro \
docker-k8s-mcp
Show me all running Docker containers and their memory usage.
The payment-service pod is crashing. Describe it and fetch the last 200 log lines.
Restart the api-gateway deployment in the production namespace.
Which pods in the staging namespace have more than 5 restarts?
main.go - server init, signal handling, graceful shutdown
tools/docker.go - Docker tool definitions and handlers
tools/k8s.go - Kubernetes tool definitions and handlers
internal/docker/client.go - Docker SDK client
internal/docker/tools.go - Docker logic
internal/k8s/client.go - Kubernetes client (in-cluster + kubeconfig)
internal/k8s/tools.go - Kubernetes logic
Transport: stdio (JSON-RPC 2.0 over stdin/stdout).
MCP server to manage Docker and Kubernetes through Claude
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Docker K8s 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 MCP server to manage Docker and Kubernetes through Claude