Docker Hub
Enables LLMs to search Docker Hub repositories, discover container images, and manage Docker Hub repositories and tags through natural language queries. Supports both public content access and authenticated operations with Docker Personal Access Toke
What is Docker Hub?
Docker Hub is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables llms to search docker hub repositories, discover container images, and manage docker hub repositories and tags through natural language queries. supports both public content access and authent...
Enables LLMs to search Docker Hub repositories, discover container images, and manage Docker Hub repositories and tags through natural language queries. Supports both public content access and authenticated operations with Docker Personal Access Toke
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables LLMs to search Docker Hub repositories, discover con
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx docker-hub-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Docker Hub
The Docker Hub MCP server is an official Docker tool that enables AI assistants to search Docker Hub repositories, discover and evaluate container images, manage repository metadata, and inspect image tags — all through natural language queries. It supports both unauthenticated public content discovery and authenticated operations using a Docker Personal Access Token for managing your own repositories. Development teams can use it to find the right base images, inspect available tags by architecture or OS, and manage Docker Hub content without leaving their AI coding workflow.
Prerequisites
- Node.js 18+ and npm installed
- A Docker Hub account (free tier sufficient for public image search)
- A Docker Hub Personal Access Token (PAT) for authenticated and write operations — generate at hub.docker.com/settings/security
- An MCP-compatible client such as Claude Desktop or Cursor
Clone the repository
Download the Docker Hub MCP server from the official Docker GitHub repository.
git clone https://github.com/docker/hub-mcp.git
cd hub-mcpInstall dependencies and build
Install npm dependencies and compile the TypeScript source to JavaScript.
npm install
npm run buildTest the server manually
Start the server in stdio mode to verify it works. For authenticated operations, pass your Docker Hub username and PAT token.
HUB_PAT_TOKEN=your_pat_token node dist/index.js --transport=stdio --username=your_dockerhub_usernameConfigure Claude Desktop
Add the server to your claude_desktop_config.json. Use the absolute path to the built dist/index.js file.
{
"mcpServers": {
"docker-hub": {
"command": "node",
"args": ["/absolute/path/to/hub-mcp/dist/index.js", "--transport=stdio"],
"env": {
"HUB_PAT_TOKEN": "your_docker_hub_personal_access_token"
}
}
}
}Search for images and manage repositories
Once configured, you can search Docker Hub repositories, list tags filtered by architecture, create or update repositories, and query Docker Hardened Images through your AI assistant.
Docker Hub Examples
Client configuration
Claude Desktop configuration for the Docker Hub MCP server with PAT authentication.
{
"mcpServers": {
"docker-hub": {
"command": "node",
"args": ["/home/user/hub-mcp/dist/index.js", "--transport=stdio"],
"env": {
"HUB_PAT_TOKEN": "dckr_pat_your_personal_access_token"
}
}
}
}Prompts to try
Natural language queries you can use with the Docker Hub MCP server.
- "Search for official nginx images on Docker Hub"
- "List all tags for the postgres image filtered to linux/amd64"
- "Show me the most secure Node.js base image available"
- "List all repositories in my Docker Hub namespace"
- "What Docker Hardened Images are available for Python?"Troubleshooting Docker Hub
Authentication error or 401 Unauthorized
Verify your HUB_PAT_TOKEN is valid and has not expired. Generate a new token at hub.docker.com/settings/security. Ensure the token has the correct scopes (Read, Write, or Delete depending on your use case).
Server fails to start: 'Cannot find module dist/index.js'
Run npm run build in the hub-mcp directory to compile the TypeScript source. Ensure the path in your MCP config args points to the correct absolute location of dist/index.js.
Search returns empty results for a known image
Docker Hub search may use different query semantics than the website. Try searching with just the image name (e.g., 'nginx' not 'library/nginx'). Public images are accessible without authentication — omitting the PAT token does not prevent searching.
Frequently Asked Questions about Docker Hub
What is Docker Hub?
Docker Hub is a Model Context Protocol (MCP) server that enables llms to search docker hub repositories, discover container images, and manage docker hub repositories and tags through natural language queries. supports both public content access and authenticated operations with docker personal access toke It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Docker Hub?
Follow the installation instructions on the Docker Hub GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Docker Hub?
Docker Hub works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Docker Hub free to use?
Yes, Docker Hub is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Docker Hub Alternatives — Similar Cloud Services Servers
Looking for alternatives to Docker Hub? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Docker Hub in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Docker Hub?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.