Как подключить Docker Hub к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Docker Hub, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Docker Hub + Gemini

Дайте ИИ искать образы контейнеров на Docker Hub: искать репозитории, читать описание и число скачиваний образа, просматривать теги с дайджестами, размерами и датами публикации, сравнивать платформы тега и видеть репозитории ваши и ваших организаций.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

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 или Read-only, если ИИ должен видеть и ваши приватные репозитории. Токен начинается с dckr_pat_.
3. Укажите ваш Docker ID (имя пользователя, а не адрес электронной почты) в DOCKERHUB_USERNAME и токен в DOCKERHUB_TOKEN, затем установите коннектор. Коннектор обменивает их на краткосрочный токен доступа и сам его обновляет; персональный токен доступа отправляется только на hub.docker.com.
4. Проверьте настройку с помощью dockerhub_get_user: он показывает аккаунт, которому принадлежит токен.

Только чтение: коннектор никогда не создаёт, не меняет и не удаляет репозитории и теги, поэтому подтверждать или отключать ничего не нужно.

Имена образов: образ записывается как namespace/repository. Docker Official Images, например nginx, postgres или python, находятся в namespace library, поэтому nginx означает library/nginx. Тегом называется часть после двоеточия, как в nginx:1.27-alpine.

Что ИИ может узнать:

• Найти образы: dockerhub_search_repositories ищет по имени или ключевому слову и показывает число скачиваний и звёзд, а также является ли образ Docker Official Image.
• Изучить один: dockerhub_get_repository читает описание, README, число скачиваний, дату последнего обновления и категории.
• Версии: dockerhub_list_tags показывает теги, сначала самые новые, с фильтром по части имени, с дайджестом, сжатым размером и датой последней публикации. dockerhub_get_tag показывает для одного тега образ каждой платформы (ОС, архитектура, вариант, дайджест и размер). Так можно проверить, есть ли тег для arm64, когда его в последний раз пересобирали и указывают ли два тега на один и тот же дайджест.
• Ваш аккаунт: dockerhub_list_my_orgs перечисляет организации, в которых вы состоите, dockerhub_get_org читает публичный профиль организации, включая значок verified publisher, а dockerhub_list_repositories перечисляет все репозитории пользователя или организации, включая приватные, если токен может их читать.

Лимиты на pull: dockerhub_pull_limits объясняет, сколько скачиваний образов Docker Hub разрешает для каждого типа аккаунта (например 100 за 6 часов для анонимных pull и 200 для аккаунта Personal после входа), и как проверить остаток на машине, которая скачивает образы. Вызовы этого коннектора являются запросами к API, а не скачиванием образов, и в лимит не засчитываются.

Нет данных об уязвимостях: у Docker Scout нет публичного API, поэтому коннектор не может показать CVE. Для этого используйте страницу Docker Scout образа на hub.docker.com или команду docker scout.

Недоверенный контент: описания и README репозиториев пишут их издатели. ИИ воспринимает инструкции в них как данные, а не как команды.

Частые ошибки: 401 при входе: неверный Docker ID или токен, либо токен отозван или истёк; используйте Docker ID, а не адрес почты, и создайте новый токен. 401 или 403 в dockerhub_get_user, хотя публичные запросы работают: это токен доступа организации; используйте персональный токен доступа. 404: namespace, репозиторий или тег не существует, либо он приватный и токен не может его читать; для официальных образов нужен namespace library. 429: Docker Hub ограничивает число запросов к API на аккаунт и IP; подождите минуту и повторите.

Коннектор не создаёт репозитории, не публикует образы, не удаляет теги, не управляет командами и участниками, токенами доступа и журналами аудита и не показывает результаты Docker Scout.

Шаг 2 — Установите адаптер

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 читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

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

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Docker Hub.

Доступные инструменты

Примеры запросов

• «Есть ли образ linux/arm64 для postgres:16-alpine и когда его в последний раз публиковали?»
• «Покажи десять последних обновлённых тегов node, содержащих alpine, с их сжатым размером.»
• «Указывают ли сейчас nginx:stable-alpine и nginx:alpine на один и тот же дайджест?»
• «Покажи все репозитории нашей организации acme, включая приватные, по убыванию числа скачиваний.»
• «Найди на Docker Hub образы Keycloak и скажи, какой из них официальный или от verified publisher.»
• «Объясни лимиты на pull для бесплатного аккаунта Docker и как проверить, сколько скачиваний осталось у нашего CI-раннера.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT