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 命令 。

小结

简而言之，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 命令支持功能一览

三、MCP模板

下面是一个完整的 MCP 示例项目模板，包括项目结构、核心配置、Secrets 示例，以及如何通过 docker mcp 命令进行初始化与部署

示例目标

我们将创建一个 MCP 工程，包含以下组件：

项目结构预览

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