Docker Hub — Claude Code MCP server: what it does, how to run
Connects LLMs to the Docker Hub API to search container images, inspect registries, and manage repositories through plain prompts.
no license updated 2026-10-29
Open on GitHubWhat Docker Hub does
This server connects AI clients to the Docker Hub API. Without credentials, it retrieves public container metadata and finds base images. Supplying a HUB_PAT_TOKEN lets the model inspect and modify your private repositories.
Running the project requires Node.js 22+ alongside Docker. You build the package locally using npm install followed by npm run build. It runs over stdio by default or serves HTTP requests on port 3000.
The HTTP transport fails closed: the process refuses to start unless you set MCP_AUTH_TOKEN or explicitly bypass authentication.
What it helps with
- find optimal container base images for your project stack
- check public Docker Hub tags and build metadata
- manage registry repositories using an access token
Example prompts for the agent
- Find the official Node.js Docker image built on Alpine
- Check recent tags for the public python repository
- List my Docker Hub repositories using my configured PAT
How to install Docker Hub
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Docker Hub
How do you build and run the Docker Hub MCP server?
Build the project with npm install and npm run build. Then launch it via npm start -- --transport=stdio or reference dist/index.js inside your client config.
What does Docker Hub MCP server do?
It gives coding assistants direct access to search container images, verify tags, and manage repository assets.
Is a personal access token mandatory?
Public queries work without credentials. Managing private repositories or modifying registry content requires passing a HUB_PAT_TOKEN.