🐳 Docker Mcp

Creado por

QuantGeekDev•Aug 22, 2025

Un servidor MCP de Docker (protocolo de contexto de modelo)

Resumen

¿Qué es Docker MCP?

Docker MCP (Protocolo de Contexto de Modelo) es un servidor diseñado para facilitar la gestión y orquestación de aplicaciones en contenedores. Proporciona una forma estandarizada de manejar contextos de modelo, permitiendo a los desarrolladores desplegar, gestionar y escalar sus aplicaciones de manera eficiente utilizando contenedores Docker. Docker MCP es particularmente útil para equipos que buscan optimizar sus procesos de desarrollo y mejorar la colaboración en diferentes entornos.

Características de Docker MCP

Gestión de Contenedores: Docker MCP simplifica la gestión de contenedores, permitiendo a los usuarios desplegar, actualizar y escalar aplicaciones fácilmente.
Protocolo Estandarizado: Utiliza un protocolo estandarizado para contextos de modelo, asegurando compatibilidad y facilidad de integración con diversas herramientas y servicios.
Escalabilidad: La arquitectura de Docker MCP permite la escalabilidad sin problemas de las aplicaciones, acomodando cargas aumentadas sin comprometer el rendimiento.
Interfaz Amigable: Docker MCP ofrece una interfaz intuitiva que facilita a los desarrolladores interactuar con sus aplicaciones en contenedores.
Código Abierto: Al ser un proyecto de código abierto, Docker MCP fomenta las contribuciones y la colaboración de la comunidad, promoviendo la innovación y la mejora continua.

Cómo Usar Docker MCP

Instalación: Comienza instalando Docker en tu máquina. Sigue la documentación oficial de Docker para las instrucciones de instalación.
Clonar el Repositorio: Usa Git para clonar el repositorio de Docker MCP desde GitHub:
```
git clone https://github.com/QuantGeekDev/docker-mcp.git
```
Configuración: Navega al directorio clonado y configura los ajustes necesarios en los archivos de configuración según los requisitos de tu proyecto.
Ejecutar el Servidor: Inicia el servidor Docker MCP utilizando comandos de Docker. Asegúrate de que todas las dependencias estén satisfechas y el entorno esté correctamente configurado.
Desplegar Aplicaciones: Usa la interfaz de Docker MCP para desplegar tus aplicaciones, gestionar contenedores y monitorear el rendimiento.
Escalado: A medida que tu aplicación crece, utiliza las características de escalado de Docker MCP para manejar el aumento de tráfico y demandas de recursos.

Preguntas Frecuentes

P1: ¿Cuáles son los requisitos del sistema para Docker MCP?

R1: Docker MCP requiere una máquina con Docker instalado. Se recomienda tener al menos 4GB de RAM y un procesador de múltiples núcleos para un rendimiento óptimo.

P2: ¿Es Docker MCP adecuado para entornos de producción?

R2: Sí, Docker MCP está diseñado para ser robusto y escalable, lo que lo hace adecuado para entornos de producción. Sin embargo, se recomienda realizar pruebas exhaustivas antes del despliegue.

P3: ¿Puedo contribuir a Docker MCP?

R3: ¡Absolutamente! Docker MCP es un proyecto de código abierto, y las contribuciones son bienvenidas. Puedes enviar problemas, solicitudes de características o solicitudes de extracción en el repositorio de GitHub.

P4: ¿Cómo se compara Docker MCP con otras herramientas de orquestación de contenedores?

R4: Docker MCP se centra en la gestión de contextos de modelo y proporciona una interfaz amigable, lo que facilita a los desarrolladores gestionar sus aplicaciones en comparación con algunas herramientas de orquestación más complejas.

P5: ¿Dónde puedo encontrar documentación para Docker MCP?

R5: La documentación para Docker MCP se puede encontrar en el archivo README del repositorio y en recursos adicionales vinculados dentro del repositorio.

Detalle

🐳 docker-mcp

A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.

✨ Features

🚀 Container creation and instantiation
📦 Docker Compose stack deployment
🔍 Container logs retrieval
📊 Container listing and status monitoring

🎬 Demos

Deploying a Docker Compose Stack

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

Analyzing Container Logs

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

🚀 Quickstart

To try this in Claude Desktop app, add this to your claude config files:

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

Installing via Smithery

To install Docker MCP for Claude Desktop automatically via Smithery:

npx @smithery/cli install docker-mcp --client claude

Prerequisites

UV (package manager)
Python 3.12+
Docker Desktop or Docker Engine
Claude Desktop

Installation

Claude Desktop Configuration

Add the server configuration to your Claude Desktop config file:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

<details> <summary>💻 Development Configuration</summary>

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-docker-mcp>",
        "run",
        "docker-mcp"
      ]
    }
  }
}

</details> <details> <summary>🚀 Production Configuration</summary>

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

</details>

🛠️ Development

Local Setup

Clone the repository:

git clone https://github.com/QuantGeekDev/docker-mcp.git
cd docker-mcp

Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:

uv sync

🔍 Debugging

Launch the MCP Inspector for debugging:

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

The Inspector will provide a URL to access the debugging interface.

📝 Available Tools

The server provides the following tools:

create-container

Creates a standalone Docker container

{
    "image": "image-name",
    "name": "container-name",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "value"}
}

deploy-compose

Deploys a Docker Compose stack

{
    "project_name": "example-stack",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

get-logs

Retrieves logs from a specific container

{
    "container_name": "my-container"
}

list-containers

Lists all Docker containers

{}

🚧 Current Limitations

No built-in environment variable support for containers
No volume management
No network management
No container health checks
No container restart policies
No container resource limits

🤝 Contributing

Fork the repository from docker-mcp
Create your feature branch
Commit your changes
Push to the branch
Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

✨ Authors

Alex Andru - Initial work | Core contributor - @QuantGeekDev
Ali Sadykov - Initial work | Core contributor - @md-archive

Made with ❤️

Configuración del Servidor

{
  "mcpServers": {
    "docker-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/metorial/mcp-container--quantgeekdev--docker-mcp--docker-mcp",
        "docker-mcp"
      ],
      "env": {}
    }
  }
}

Información del Proyecto

Autor

QuantGeekDev