如何通过 MCP 将 Docker Hub 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Docker Hub、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Docker Hub + Gemini

让你的 AI 在 Docker Hub 上查询容器镜像：搜索仓库，读取镜像的说明和拉取次数，列出带摘要、大小和推送日期的标签，比较某个标签的平台，并查看你自己和你所在组织的仓库。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

DOCKERHUB_USERNAME, DOCKERHUB_TOKEN

步骤 1 — 获取凭证

1. 登录 https://app.docker.com，打开 Account settings → Personal access tokens（https://app.docker.com/settings/personal-access-tokens）。
2. 创建一个访问权限为 Public Repo Read-only 的令牌；如果希望 AI 也能看到你的私有仓库，请选 Read-only。令牌以 dckr_pat_ 开头。
3. 在 DOCKERHUB_USERNAME 中填写你的 Docker ID（用户名，不是邮箱地址），在 DOCKERHUB_TOKEN 中填写令牌，然后安装连接器。连接器会用它们换取一个短时有效的访问令牌并自动续期；个人访问令牌只会发送到 hub.docker.com。
4. 用 dockerhub_get_user 检查设置：它会显示令牌所属的账户。

只读：该连接器从不创建、修改或删除仓库和标签，因此没有需要确认或关闭的操作。

镜像名称：镜像写作 namespace/repository。nginx、postgres、python 等 Docker Official Images 位于 library 命名空间，所以 nginx 就是 library/nginx。标签是冒号后面的部分，例如 nginx:1.27-alpine。

AI 可以查询的内容：

• 查找镜像：dockerhub_search_repositories 按名称或关键词搜索，显示拉取次数、星标数以及是否为 Docker Official Image。
• 查看单个镜像：dockerhub_get_repository 读取说明、README、拉取次数、最近更新时间和分类。
• 版本：dockerhub_list_tags 按从新到旧列出标签，可按名称片段筛选，并显示摘要、压缩后大小和最近推送时间。dockerhub_get_tag 显示某个标签在每个平台上的镜像（操作系统、架构、变体、摘要和大小）。可用来确认某个标签是否有 arm64 版本、最近一次重新构建是什么时候，或两个标签是否指向同一个摘要。
• 你的账户：dockerhub_list_my_orgs 列出你所在的组织，dockerhub_get_org 读取组织的公开资料（包括认证发布者徽章），dockerhub_list_repositories 列出某个用户或组织的全部仓库，令牌有权读取时也包括私有仓库。

拉取限制：dockerhub_pull_limits 说明 Docker Hub 对各类账户允许的拉取次数（例如匿名拉取每 6 小时 100 次，已登录的 Personal 账户 200 次），以及如何在执行拉取的机器上查看剩余次数。该连接器的调用是 API 请求，不是镜像拉取，不计入限制。

没有漏洞数据：Docker Scout 没有公开 API，因此连接器无法显示 CVE。请使用 hub.docker.com 上该镜像的 Docker Scout 页面或 docker scout 命令。

不可信内容：仓库说明和 README 由发布者撰写。AI 会把其中的指令当作数据，而不是命令。

常见错误：登录时返回 401：Docker ID 或令牌错误，或令牌已撤销或过期；请使用 Docker ID 而不是邮箱，并创建新令牌。公开查询正常但 dockerhub_get_user 返回 401 或 403：填写的是组织访问令牌；请使用个人访问令牌。404：命名空间、仓库或标签不存在，或它是私有的且令牌无权读取；官方镜像需要 library 命名空间。429：Docker Hub 按账户和 IP 限制 API 请求；等一分钟再试。

该连接器不会创建仓库、推送镜像、删除标签，不管理团队和成员、访问令牌或审计日志，也不显示 Docker Scout 结果。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Docker Hub 的工具。

可用工具

示例提示

• “postgres:16-alpine 有 linux/arm64 镜像吗？最近一次推送是什么时候？”
• “列出 node 中包含 alpine 的最近更新的十个标签，并显示压缩后大小。”
• “nginx:stable-alpine 和 nginx:alpine 现在指向同一个摘要吗？”
• “按拉取次数排序，显示我们组织 acme 的全部仓库，包括私有仓库。”
• “在 Docker Hub 上搜索 Keycloak 镜像，告诉我哪个是官方镜像或来自认证发布者。”
• “解释一下免费 Docker 账户的拉取限制，以及我怎样查看我们的 CI 运行器还剩多少次拉取。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT