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.0

agent:
  name: gordon
  description: "Local AI agent with Claude and GitHub plugin"

models:
  - name: llama3
    runtime: ollama
    autoStart: true

clients:
  - name: claude
    api_key: ${claude.api_key}
    autoConnect: true

plugins:
  - name: github
    token: ${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