Docker Desktop 4.42集成的MCP工具包
一、介绍
Docker Desktop 4.42 集成了 MCP(Model‑Client‑Plugin)Toolkit,无需额外安装扩展即可直接使用。
MCP Toolkit 集成细节
-
内置于 Docker Desktop:你可以直接打开应用,在设置中启用 MCP 服务器,比如 GitHub、MongoDB、HashiCorp 等,连接客户端(如 Claude Desktop、Cursor)或 Docker 自家的 AI 代理 Gordon。
-
安全隔离:MCP 服务器以容器形式运行,具备签名验证、隔离的 secret 管理机制,从系统安全角度更受保护。
-
命令行支持:新增
docker mcp
子命令,支持通过 CLI 管理 MCP 目录、客户端连接、secret 配置等。 -
AI Agent Gordon 升级:在 Gordon 中开启 MCP,就能看到并使用你配置的 MCP 工具,让 AI 功能更丰富。
此外,本次 4.42 版本还带来了原生 IPv6 支持、智能 DNS 解析、Model Runner 扩展(支持 Qualcomm 芯片)、以及 docker model package
命令 。
小结
功能 | 是否集成 |
---|---|
MCP Toolkit | ✅ 内置,无需插件 |
docker mcp CLI | ✅ 可用 |
安全容器运行 MCP | ✅ 支持 |
AI Agent Gordon 集成 MCP | ✅ 支持 |
简而言之,Docker Desktop 4.42 已经原生集成 MCP 工具包,安装后即可直接开启并使用,无需额外插件安装。
二、新增命令介绍
在 Docker Desktop 4.42 中,新增了一个重要的命令组,这是为管理 MCP 工具链(模型、客户端、插件) 而引入的新命令集合,主要用于以下方面:
1. docker mcp init
功能: 初始化一个 MCP 工程目录。
docker mcp init
-
创建标准的 MCP 项目结构,包含:
.mcp/ ├── plugins/ ├── clients/ ├── models/ └── secrets/
2. docker mcp add <component>
功能: 添加 MCP 组件,如模型、插件或客户端。
docker mcp add plugin <plugin-name>
docker mcp add model <model-name>
docker mcp add client <client-name>
-
例如:
docker mcp add plugin github docker mcp add model llama3 docker mcp add client claude
-
添加后 Docker 会从仓库下载并部署组件(通常是 OCI 镜像或容器化服务)。
3. docker mcp secret
功能: 管理 MCP 组件使用的密钥和凭证(如 GitHub Token、OpenAI Key 等)。
docker mcp secret add github.token
docker mcp secret list
-
支持通过安全方式将 secrets 存储在
.mcp/secrets/
中(非明文存储)。 -
例如:
docker mcp secret add github.token=ghp_abc123
4. docker mcp up
/ down
功能: 启动或停止 MCP 工程中的服务(类似 docker compose up/down
)。
docker mcp up
docker mcp down
-
自动拉取所需镜像,并启动模型服务、插件服务和客户端代理。
5. docker mcp list
功能: 列出所有已配置的组件(模型/插件/客户端)。
docker mcp list
-
可查看当前激活状态的 MCP 组件及版本信息。
6. docker mcp config
功能: 显示或修改 .mcp/config.yaml
文件内容。
docker mcp config view
docker mcp config set agent.name=gordon
示例:快速体验命令流
docker mcp init
docker mcp add model llama3
docker mcp add client claude
docker mcp secret add openai.key=sk-xxxx
docker mcp up
这样就会自动部署 Claude + LLaMA + 接口桥接器(如你启用了 Gordon),形成一个“本地 AI agent 工程”。
总结:docker mcp
命令支持功能一览
命令 | 功能 |
---|---|
init | 初始化 MCP 项目目录 |
add | 添加模型/插件/客户端 |
secret | 管理安全凭证 |
up / down | 启动/停止所有服务 |
list | 显示组件列表 |
config | 配置文件管理 |
三、MCP模板
下面是一个完整的 MCP 示例项目模板,包括项目结构、核心配置、Secrets 示例,以及如何通过 docker mcp
命令进行初始化与部署
示例目标
我们将创建一个 MCP 工程,包含以下组件:
类型 | 名称 | 功能说明 |
---|---|---|
Model | llama3 | 本地运行的 LLM(使用 Ollama) |
Client | claude | Claude 客户端,用于对话接口 |
Plugin | github | 读取 GitHub 仓库内容 |
项目结构预览
my-mcp-project/
├── .mcp/
│ ├── models/
│ ├── clients/
│ ├── plugins/
│ ├── secrets/
│ └── config.yaml
├── README.md
1. 初始化项目
mkdir my-mcp-project
cd my-mcp-project
docker mcp init
2. 添加模型、客户端、插件
docker mcp add model llama3
docker mcp add client claude
docker mcp add plugin github
3. 添加安全凭证(Secrets)
docker mcp secret add github.token=ghp_your_github_token
docker mcp secret add claude.api_key=sk-your-anthropic-key
Secrets 会以加密方式写入 .mcp/secrets/
目录,示例:
# .mcp/secrets/github.token
value: ghp_your_github_token
4. .mcp/config.yaml
示例配置
version: 1.0agent:name: gordondescription: "Local AI agent with Claude and GitHub plugin"models:- name: llama3runtime: ollamaautoStart: trueclients:- name: claudeapi_key: ${claude.api_key}autoConnect: trueplugins:- name: githubtoken: ${github.token}autoLoad: true
5. 启动项目
docker mcp up
这会自动启动:
-
llama3
模型容器(如使用 Ollama) -
claude
客户端连接服务 -
github
插件服务
示例对话交互
启动后,可以在 Docker Desktop → Gordon 中打开 Claude client,与模型和插件交互,例如:
🧠 Prompt: 请使用 GitHub 插件列出 OpenAI 的开源项目
一键创建脚本(可保存为 init.sh
)
#!/bin/bash
mkdir my-mcp-project
cd my-mcp-project
docker mcp init
docker mcp add model llama3
docker mcp add client claude
docker mcp add plugin github
docker mcp secret add github.token=ghp_your_github_token
docker mcp secret add claude.api_key=sk-your-anthropic-key
docker mcp up