Docker Hub MCP Server provides integration with Docker Hub through the Model Context Protocol, enabling image search, query, and management capabilities.

Features

🔍 Image Search - Search for images on Docker Hub
📊 Image Info - Get detailed image information
🏷️ Tag Management - View image tags
📈 Statistics - View download counts and stars
👤 User Management - Manage Docker Hub account
📝 Repository Info - Repository information queries

Environment Variables

Variable	Default	Description
`DOCKERHUB_MCP_VERSION`	`latest`	Docker image version
`DOCKERHUB_MCP_PORT_OVERRIDE`	`8000`	Service port
`DOCKERHUB_USERNAME`	-	Docker Hub username (optional, for auth)
`DOCKERHUB_PASSWORD`	-	Docker Hub password (optional, for auth)
`DOCKERHUB_TOKEN`	-	Docker Hub access token (recommended for auth)
`TZ`	`UTC`	Timezone

Authentication Methods

The service supports three authentication methods:

1. No Authentication (Public Access)

Only public images and information can be accessed.

2. Username & Password Authentication

DOCKERHUB_USERNAME=your_username
DOCKERHUB_PASSWORD=your_password

3. Access Token Authentication (Recommended)

DOCKERHUB_TOKEN=your_access_token

Quick Start

1. Configure Environment

Create a .env file:

No Authentication Mode (Public Access Only)

DOCKERHUB_MCP_VERSION=latest
DOCKERHUB_MCP_PORT_OVERRIDE=8000
TZ=Asia/Shanghai

Token Authentication Mode (Recommended)

DOCKERHUB_MCP_VERSION=latest
DOCKERHUB_MCP_PORT_OVERRIDE=8000
DOCKERHUB_TOKEN=dckr_pat_your_token_here
TZ=Asia/Shanghai

2. Get Docker Hub Access Token

Login to Docker Hub
Click avatar → Account Settings
Navigate to Security → Access Tokens
Click New Access Token
Set permissions (read-only recommended)
Generate and copy the token

3. Start Service

docker compose up -d

4. Verify Service

curl http://localhost:8000/health

Resource Requirements

Minimum memory: 128MB
Recommended memory: 512MB
CPU: 0.25-1.0 cores

Common Use Cases

Image Search - Search for Docker images suitable for projects
Version Query - View all available tags for an image
Dependency Analysis - Analyze base images and dependencies
Security Check - View image security scan reports
Download Statistics - Check image popularity

API Features

The MCP server provides the following main features:

✅ Search public and private images
✅ Get image tag lists
✅ View detailed image information
✅ Query repository statistics
✅ Check for image updates
✅ View Dockerfiles

Permission Types

Read-Only Token Permissions

Recommended for most query operations:

✅ Search images
✅ View image information
✅ Get tag lists
❌ Push images
❌ Delete images

Read-Write Token Permissions

For management operations:

✅ All read-only operations
✅ Push images
✅ Delete images
✅ Update repository settings

Security Recommendations

⚠️ Important:

Prefer Access Tokens: More secure than passwords
Least Privilege: Only grant necessary permissions
Regular Rotation: Update access tokens regularly
Protect Environment Variables: Don't commit .env to version control
Monitor Access: Regularly check token usage
Use Read-Only Tokens: Unless write access is needed

Rate Limits

Docker Hub has API rate limits:

Unauthenticated: 100 requests/6 hours
Free Account: 200 requests/6 hours
Paid Account: Higher rate limits

Authentication is recommended for higher rate limits.

References

License

MIT License

通过 AI 可以进行以下查询:

"搜索 nginx 相关的镜像"
"查看 python:3.11 镜像的所有标签"
"获取 redis:alpine 镜像的详细信息"
"查找最流行的 PostgreSQL 镜像"
"比较不同 Node.js 镜像的大小"

参考链接

许可证

MIT License