Docker MCP Toolkit
Run, manage, and invoke Docker Desktop’s MCP Toolkit using the docker mcp CLI.
Install + preflight (Docker Desktop)
1) Install/upgrade Docker Desktop (MCP Toolkit is in Docker Desktop 4.62+ per docs).
2) Enable MCP Toolkit:
- - Docker Desktop → Settings → Beta features → Enable Docker MCP Toolkit → Apply.
3) Preflight:
CODEBLOCK0
Quick start
List enabled servers/tools:
CODEBLOCK1
Core operations
- - List/enable/disable servers:
-
./scripts/servers.sh
-
./scripts/server-enable.sh <server-name>
- INLINECODE3
- INLINECODE4
- - Invoke a tool (via Docker’s gateway/tool runner):
CODEBLOCK2
Notes:
- -
call-tool.sh requires jq. - INLINECODE7 uses
key=value tokens. - Non-string values use
:= (example: limit:=5, activate:=true). - This skill currently supports only primitive JSON values (string/number/bool/null). Nested objects/arrays are rejected.
- For tools requiring object arguments (e.g.
mcp-config-set), call docker mcp tools inspect <tool> --format json then run docker mcp tools call ... directly until this skill adds a tested encoder.
How invocation works (important)
Docker MCP Toolkit runs an MCP Gateway and exposes tools through it. This skill intentionally uses the docker mcp tools … commands so OpenClaw can invoke tools without needing native MCP client support.
If you need a true MCP client connection (stdio/SSE), pair this skill with the mcporter skill.
Secrets and safety
- - Prefer Docker Desktop’s secrets/keychain integration when possible.
- Do not expose gateway ports publicly.
- Use least-privilege credentials (separate Neon role with only required grants).
For hardening guidance, read: references/security.md.
Troubleshooting
- - If commands say “Docker Desktop is not running”: start Docker Desktop.
- If MCP Toolkit isn’t visible: confirm it’s enabled in Beta features.
- If a tool call fails: run
docker mcp tools --verbose inspect <tool> and check Docker Desktop MCP Toolkit UI for server configuration.
Docker MCP 工具包
使用 docker mcp CLI 运行、管理和调用 Docker Desktop 的 MCP 工具包。
安装与预检（Docker Desktop）
1) 安装/升级 Docker Desktop（根据文档，MCP 工具包包含在 Docker Desktop 4.62+ 版本中）。
2) 启用 MCP 工具包：
- - Docker Desktop → 设置 → Beta 功能 → 启用 Docker MCP 工具包 → 应用。
3) 预检：
bash
./scripts/preflight.sh
快速开始
列出已启用的服务器/工具：
bash
./scripts/servers.sh
./scripts/tools.sh
核心操作
- ./scripts/servers.sh
- ./scripts/server-enable.sh <服务器名称>
- ./scripts/server-disable.sh <服务器名称>
- ./scripts/tools.sh
- - 调用工具（通过 Docker 的网关/工具运行器）：
bash
./scripts/call-tool.sh --tool mcp-find --json {query:postgres,limit:5}
注意：
- - call-tool.sh 需要 jq。
- docker mcp tools call 使用 key=value 令牌。
- 非字符串值使用 :=（例如：limit:=5，activate:=true）。
- 此技能目前仅支持原始 JSON 值（字符串/数字/布尔值/null）。嵌套对象/数组将被拒绝。
- 对于需要对象参数的工具（例如 mcp-config-set），请调用 docker mcp tools inspect --format json，然后直接运行 docker mcp tools call ...，直到此技能添加经过测试的编码器。
调用方式（重要）
Docker MCP 工具包运行一个 MCP 网关并通过它暴露工具。此技能特意使用 docker mcp tools … 命令，以便 OpenClaw 无需原生 MCP 客户端支持即可调用工具。
如果您需要真正的 MCP 客户端连接（stdio/SSE），请将此技能与 mcporter 技能配对使用。
机密与安全
- - 尽可能优先使用 Docker Desktop 的机密/钥匙串集成。
- 不要公开暴露网关端口。
- 使用最小权限凭证（单独的 Neon 角色，仅授予所需权限）。
有关加固指南，请阅读：references/security.md。
故障排除
- - 如果命令提示“Docker Desktop 未运行”：启动 Docker Desktop。
- 如果 MCP 工具包不可见：确认已在 Beta 功能 中启用。
- 如果工具调用失败：运行 docker mcp tools --verbose inspect 并检查 Docker Desktop MCP 工具包 UI 中的服务器配置。
