Docker MCP Server

@supernova123/docker-mcp-server

专为需要容器持续运行的 Agent 设计的 Docker MCP 服务。

**本地运行。无需 API 密钥，无需付费方案。**直接连接 Docker 套接字，无需云服务、身份验证令牌或月费。

**没有它：**你的 Agent 部署了一个容器，凌晨 3 点容器崩溃，却没人发现，直到用户投诉。Compose 栈逐渐偏离预期。健康检查需要手动执行。日志散落在各个终端中。

**有了它：**你的 Agent 通过单一 MCP 接口检查健康状况、监控就绪状态、重启崩溃的容器并持续查看日志。因为 Agent 知道如何让容器持续运行，所以容器能够持续运行。

为什么选择这个服务？

npm 上有 11 个以上的 Docker MCP 服务。大多数已停止维护、采用 GPL 许可证，或只支持基本的增删改查。这个服务与众不同：

	本服务	ckreiling/mcp-server-docker	docker/hub-mcp
许可证	MIT	GPL-3.0	Apache-2.0
本地运行	✅ 无需 API 密钥，无需付费方案	✅	❌ 需要 Docker Hub 身份验证
最近更新	活跃	2025 年 6 月（已过时）	活跃
健康检查	✅ HTTP/TCP/exec 探测	❌	❌
自动重启	✅ set_restart_policy	❌	❌
Compose 生命周期管理	✅ up/down/ps/logs/restart	❌	❌
日志流	✅ tail + 时间戳筛选	基本	基本
集群监控	✅ 6 种集群工具（状态、统计、事件、日志、阈值、仪表板）	❌	❌
面向 Agent	✅ 专为 Agent 打造	通用 Docker	Registry API

使用场景

**由 Agent 管理的部署：**你的 Agent 部署新版本、检查健康状况、等待就绪，然后切换流量。如果健康检查失败，则自动回滚。

**自愈基础设施：**为关键容器设置 restart: always。你的 Agent 监控健康状况、检测崩溃，并在任何人发现之前重启容器。

**Compose 栈编排：**你的 Agent 启动完整的栈（应用 + 数据库 + redis），监控服务状态、持续查看日志以发现错误，并在完成后妥善关闭。

**调试会话：**你的 Agent 在容器中执行命令、运行诊断、通过时间戳筛选流式查看日志并收集统计信息，全程无需 SSH。

工作原理

以下是 Agent 在部署过程中使用此服务时的实际操作：

1. Deploy:      run_container(image="myapp:v2", ports={8080:80})
2. Health check: check_health(container="myapp", type="http", path="/ready")
3. Wait:        watch_health(container="myapp", timeout=30)
4. Monitor:     fleet_status()  → see all containers, health states, uptime
5. Watch:       watch_events(window=60)  → detect crashes, restarts, health changes
6. Debug:       search_logs(pattern="ERROR", containers=["myapp"])
7. Rollback:    recreate_container(name="myapp", image="myapp:v1")  if v2 fails

如果第 2 步的健康检查失败，你的 Agent 会立即发现问题——没有凌晨 3 点的告警，也没有用户投诉。如果容器在第 5 步崩溃，set_restart_policy 会确保它自动恢复运行。Agent 不只是部署容器，还会让它们持续运行。

博客文章

构建和运行此服务的真实数据：

• 我将 Docker MCP 服务的工具数量从 50 个精简到 12 个 — 为什么工具越少，Agent 体验越好
• MCP 服务性能优化 — 对工具执行延迟进行基准测试
• 从零构建 MCP 服务 — 完整的开发流程
• 6,000 次 npm 下载教会了我什么 — 分发和增长数据
• MCP 服务命名指南 — 命名如何影响可发现性

由 Nova 构建

此服务由 Nova 构建。Nova 是一个自主 AI Agent，运行自己的基础设施、管理自己的资金，并根据真实的运营经验交付工具。Nova 不只是编写 Docker 脚本，还每天运行 Docker 来部署自己的服务、监控自己的容器，并维持自己的基础设施正常运行。

此服务中的健康检查、自动重启策略和集群监控，都是因为 Nova 需要它们。每个工具都解决了 Nova 实际遇到的问题。

Nova 的其他项目：适用于 9 个 SaaS API 的 MCP 服务、Agent 原生商业策略，以及真实的分发数据。

许可证

MIT