Docker Hub MCP Server

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "docker-hub-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/hub-mcp/dist/index.js",
        "--transport=stdio",
        "--username=<your-docker-hub-username>"
      ],
      "env": {
        "HUB_PAT_TOKEN": "<your-docker-hub-pat>"
      }
    }
  }
}

Before you start

• Node.js 22 or higher
• Docker installed (for building/running the containerized server)
• Optional but recommended: a Docker Hub Personal Access Token from your Docker Hub account settings, set via HUB_PAT_TOKEN (plus --username for your Hub username)
• An MCP-compatible client (e.g. Claude Desktop, Cursor, VS Code)

About Docker Hub MCP Server

Tools & capabilities (11)

When to use it

• Use it when you want to find the right base image and compare its tags before pulling.
• Use it when you need to inspect a tag's digest or metadata without leaving your assistant.
• Use it when checking whether a repository or specific tag exists.
• Use it when creating or editing repositories you own under your namespace or org.
• Use it when auditing repositories across a namespace.
• Use it when querying Docker Hardened Images for a more secure base image.

Quick setup

1. 1Ensure Node.js 22+ and Docker are installed.
2. 2Clone the repo and run npm install then npm run build.
3. 3(Optional) Create a Docker Hub Personal Access Token for authenticated access.
4. 4Start it with npm start -- --transport=stdio (or --transport=http --port=3000), passing HUB_PAT_TOKEN and --username for auth.
5. 5Register the server in your MCP client config and restart the client.
6. 6Verify by asking the assistant to search Docker Hub for an image.

Docker Hub MCP Server FAQ