MCP Docker Hub Server
Provides access to Docker Hub functionality including searching for images, retrieving image details, listing tags, getting manifests, and analyzing image layers with secure credential management.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Docker Hub Server
A Model Context Protocol (MCP) server that provides access to Docker Hub functionality through Claude with secure database storage for credentials.
Setup
Install dependencies:
npm installDatabase Setup:
Create a MySQL/MariaDB database
Run the SQL commands in
DATABASE_SETUP.mdSee
config.examplefor environment variables
Create environment variables: Create a
.envfile in the root directory with:# Database Configuration DB_HOST=localhost DB_USER=root DB_PASSWORD=your_password_here DB_NAME=docker_hub_db DB_PORT=3306 # Encryption Key (32 characters recommended) ENCRYPTION_KEY=your-secret-encryption-key-32-chars-longTo get your Docker Hub access token:
Create a new access token
Use the
docker_save_credentialstool to store securely
Run the server:
node src/index.js
Related MCP server: MySQL MCP Server
Features
Docker Hub Operations
docker_search_images: Search for Docker images on Docker Hub
Parameters:
username(required): Docker Hub usernamequery(required): Search termlimit(optional): Number of results (default: 5)page(optional): Page number (default: 1)
docker_get_image_details: Get details of a particular image
docker_list_tags: List tags for a specific image
docker_get_manifest: Get image manifest
docker_analyze_layers: Analyze image layers
Credential Management
docker_save_credentials: Save or update Docker Hub credentials securely
docker_get_credentials: Get credential metadata (username, dates)
docker_list_credentials: List all active credentials
docker_delete_credentials: Delete credentials for a user
docker_test_db_connection: Test database connectivity
Troubleshooting
EPIPE Error
If you encounter Error: write EPIPE, this usually means:
The MCP client (Claude) closed the connection unexpectedly
There's a communication issue between the client and server
Solutions:
Restart Claude
Check that your environment variables are set correctly
Ensure the server is running before opening Claude
Check the console output for any error messages
Common Issues
Database connection failed: Check database server and credentials in
.envMissing encryption key: Ensure
ENCRYPTION_KEYis set in.envInvalid credentials: Use
docker_save_credentialsto store valid credentialsNetwork issues: Check your internet connection and Docker Hub API status
Table not found: Run the SQL commands in
DATABASE_SETUP.md
Development
The server is built using:
Node.js
MCP SDK (@modelcontextprotocol/sdk)
Axios for HTTP requests
MySQL2 for database connectivity
CryptoJS for encryption
Dotenv for environment variable management
Security
All Docker Hub Personal Access Tokens (PATs) are encrypted using AES-256 encryption
Credentials are stored securely in the database
No sensitive data is exposed through the MCP tools
Soft delete ensures data recovery capability
Logs
The server provides detailed logging for debugging:
MCP Server errors
Transport errors
Docker Hub API errors
Process signals and shutdown events
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted MySQL MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Deploy and manage Jade Hosting projects from AI clients. Jade account and OAuth required.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to interact with MySQL databases through secure query execution, schema discovery, and multi-database support with configurable read/write permissions and built-in SQL injection protection.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to securely interact with MySQL databases for schema discovery, data querying, and record management with configurable access controls. It provides specialized tools for listing tables, describing structures, and performing CRUD operations within environments like Claude and VS Code.MIT
- AlicenseAqualityBmaintenanceEnables Claude Desktop to execute read-only SQL queries on MySQL databases via natural language, with dynamic connection switching and built-in security.3224 npm7MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with a MySQL database by automatically discovering its schema and retrieving full table data for analysis.ISC