Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open