一、介绍

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