适合谁
- 希望减少 token 消耗的 AI 编码工具（如 Claude、Cursor 等）的用户。
- 需要可靠、无歧义的 Docker 输出以进行自动化决策的代理。
- 使用 Docker 作为基础设施一部分的开发者，希望将 MCP 集成到他们的工作流程中。
P
29FMRS · D
Pare Docker 是 Pare 系列的一部分，专注于为 AI 代理提供结构化的 Docker 操作。它通过返回 schema 验证的 JSON 来显著减少 token 消耗，并消除解析终端文本的脆弱性。适合希望集成可靠 Docker 自动化到工作流中的开发者，但需要 Node.js 环境和 MCP 客户端的配置。
Pare Docker 是一个 MCP 服务器，将 Docker 命令行工具封装为结构化、类型化 JSON 输出。它提供如容器列表、镜像列表、日志、构建和 compose 操作等工具，并以 schema 验证的 JSON 返回结果，避免解析脆弱的终端文本，从而提升代理的可靠性并减少 token 消耗。
工具能力
docker ps
列出容器，返回类型化 JSON。
docker images
列出镜像，返回类型化 JSON。
docker logs
获取容器日志，返回类型化 JSON。
docker build
构建镜像，返回类型化 JSON。
docker compose
执行 Docker Compose 操作，返回类型化 JSON。
安装接入
- 确保 Node.js >= 20 已安装。2. 在 MCP 客户端配置中添加以下 JSON：{"mcpServers":{"pare-docker":{"command":"npx","args":["-y","@paretools/docker"]}}}。3. 重启客户端。
使用 npx 首次运行可能会较慢，可先运行 npx -y @paretools/docker 预热缓存，或全局安装 npm i -g @paretools/docker。
claude_desktop_config.json
{
"mcpServers": {
"pare-docker": {
"command": "npx",
"args": [
"-y",
"@paretools/docker"
]
}
}
}
选型与风险
不适合谁
- 需要交互式终端控制或完整 Docker CLI 功能（如 attach、exec -it）的用户。
- 不熟悉 MCP 配置或 Node.js 环境的用户。
- 需要直接访问 Docker 守护进程原始输出的用户，而非结构化数据。
所需权限
- 执行 Docker 命令所需的权限，例如访问 Docker 套接字或守护进程（取决于环境）。
- 网络访问权限，用于 npx 下载 npm 包或 Docker 镜像（如果构建时获取）。
- 文件系统权限，用于读取 Dockerfile 或构建上下文（如适用）。
风险与副作用
- 执行 Docker 命令可能影响容器、镜像或构建，例如删除容器或修改镜像。
- 错误配置或网络问题可能导致 Docker 命令失败，代理可能收到不完整的结构化数据。
- 使用 npx 可能引入供应链风险，因为每次调用都可能下载并执行远程代码。
常见排障
- 检查 Node.js 版本：确保 >= 20（运行 `node -v`）。
- 若 npx 未找到或 Windows 上出现 ENOENT，使用 `cmd /c npx` 包装器。
- 若 MCP 连接超时，设置环境变量 `MCP_TIMEOUT=30000` 或增加客户端的 initTimeout。
- 确认 Docker 守护进程正在运行，且当前用户有权限访问 Docker 套接字。
- 尝试运行 `npx -y @paretools/docker` 验证服务器启动是否正常。
使用场景
AI 代理需要以结构化方式获取 Docker 容器状态、镜像信息或日志，以便自动化操作。
在 CI/CD 流程中，代理需要解析 Docker 构建输出以进行错误检测或摘要。
通过 compose 文件管理多容器环境，代理需要类型化结果以进行编排。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
VS Code完整支持
Windsurf完整支持
Cline完整支持
Roo Code完整支持
OpenAI Codex完整支持
Gemini CLI完整支持
Zed完整支持
Continue.dev完整支持