Docker Hub MCP 서버는 모델 컨텍스트 프로토콜(MCP) 서버로, Docker Hub API와 연동하여 LLM에 접근할 수 있게 하여 지능형 콘텐츠 발견과 저장소 관리를 가능하게 합니다.

특히 AI 및 LLM 기반 워크플로우에서 컨테이너를 사용하는 개발자들은 Docker Hub 이미지의 방대한 환경에서 충분한 맥락이 부족한 경우가 많습니다. 그 결과 LLM은 적절한 이미지를 추천하는 데 어려움을 겪고, 개발자들은 구축 대신 수동으로 검색하는 데 시간을 낭비하게 됩니다.

사용 사례

• AI 기반 이미지 추천 - LLM은 정확한 컨테이너 이미지 제안을 위해 실시간 Docker 허브 데이터를 활용합니다.
• 향상된 콘텐츠 발견 - AI 도구가 개발자들이 적합한 이미지를 더 빠르게 찾을 수 있도록 돕습니다.
• 간소화된 허브 워크플로우 - 자연어를 사용해 도커 저장소와 이미지를 관리합니다.

선수 조건

• 도커 설치
• Node.js (버전 22+)
• [선택사항] 적절한 권한을 가진 Docker 개인 접근 토큰(PAT)

준비

1. 건설

2. 도망쳐라

• 기본 ARG:
• transport: http 또는 stdio 중 선택 (기본값: stdio)
• port=3000
• host=127.0.0.1 (HTTP 전송만)

Docker Hub MCP Server

The Docker Hub MCP Server is a Model Context Protocol (MCP) server that interfaces with Docker Hub APIs to make them accessible to LLMs, enabling intelligent content discovery and repository management.

Developers building with containers, especially in AI and LLM-powered workflows, often face inadequate context across the vast landscape of Docker Hub images. As a result, LLMs struggle to recommend the right images, and developers lose time manually searching instead of building.

Use Cases

• AI-powered image recommendations - LLMs access real-time Docker Hub data for accurate container image suggestions.
• Enhanced content discovery - AI tools help developers find the right images faster.
• Simplified Hub workflows - Manage Docker repositories and images using natural language.

Prerequisites

• Docker installed
• Node.js (version 22+)
• [Optional] A Docker Personal Access Token (PAT) with appropriate permissions

Setup

1. Build

   npm install
   npm run build
   

2. Run

    npm start -- [--transport=http|stdio] [--port=3000] [--host=127.0.0.1]
   

• Default args:
  • transport: Choose between http or stdio (default: stdio)
  • port=3000
  • host=127.0.0.1 (HTTP transport only) This starts the server with default settings and can only access public Docker Hub content.

[!IMPORTANT] The http transport binds to 127.0.0.1 (loopback) by default and requires authentication. See Securing the HTTP transport before exposing it to a network.

Run in inspector [Optional]

The MCP Inspector provides a web interface to test your server:

npx @modelcontextprotocol/inspector node dist/index.js [--transport=http|stdio] [--port=3000]

Securing the HTTP transport

The stdio transport is only reachable by the local process that spawns it. The http transport, however, dispatches every tool call using the server operator’s Docker Hub Personal Access Token (HUB_PAT_TOKEN). Anyone who can reach the HTTP endpoint can therefore act as that Docker Hub identity — including creating and modifying repositories. To prevent this, the HTTP transport is locked down by default:

• Loopback binding. The listener binds to 127.0.0.1 unless you pass --host= (for example --host=0.0.0.0 to expose it from a container).
• Authentication required (fail-closed). In http mode the server refuses to