一、介紹
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
?
?
?
?