mcp-server-docker

Controla contenedores, imágenes y servicios de Docker desde tu asistente de codificación con IA. Enumera, inicia, detén, lee registros, ejecuta comandos dentro de contenedores y comprueba el uso de recursos.

npx mcp-docker-server

Compatible con Claude Desktop, Cursor, VS Code Copilot y cualquier cliente compatible con MCP. No se necesitan claves API. Se conecta automáticamente a tu socket local de Docker.

Demo creado con remotion-readme-kit

Por qué

Si trabajas con Docker a diario, ya conoces la rutina: cambiar a una terminal, escribir docker ps, desplazarte por los registros, copiar los IDs de los contenedores, reiniciar servicios. Todo esto se acumula. Este servidor MCP permite que tu asistente de IA se encargue de esas tareas mientras tú te mantienes concentrado en el código. Pídele que compruebe qué contenedores están en ejecución, que muestre los registros de un servicio con fallos o que reinicie algo que se haya quedado bloqueado. Se comunica con la API de Docker a través del socket local, por lo que no hay nada que configurar ni credenciales que gestionar.

Related MCP server: Docker Manager MCP

Herramientas

Inicio rápido

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "docker": {
      "command": "npx",
      "args": ["-y", "mcp-docker-server"]
    }
  }
}

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "docker": {
      "command": "npx",
      "args": ["-y", "mcp-docker-server"]
    }
  }
}

VS Code

Añade a la configuración de usuario o a .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "docker": {
        "command": "npx",
        "args": ["-y", "mcp-docker-server"]
      }
    }
  }
}

Ejemplos

• "Enumera todos los contenedores de Docker en ejecución"

• "Muéstrame los registros del contenedor nginx"

• "Reinicia el contenedor api-server"

• "¿Cuál es el uso de CPU y memoria de mi contenedor postgres?"

• "Ejecuta ls -la /app dentro del contenedor web"

• "Enumera todas las imágenes de Docker y sus tamaños"

• "Detén todos los contenedores que estén usando la imagen anterior"

Requisitos previos

• Docker debe estar en ejecución en tu máquina

• El servidor se conecta al socket de Docker en /var/run/docker.sock (Linux/macOS) o a la tubería con nombre en Windows

• No se requieren claves API ni tokens

Agent Plugins

Este repositorio es un paquete Agent Plugins 1.0.0: plugin.json, mcp.json portátil y skills/ se distribuyen junto con el servidor MCP.

Para Cursor, clona el repositorio y cópialo o crea un enlace simbólico en ~/.cursor/plugins/local/mcp-server-docker y, a continuación, recarga la ventana. Las habilidades y MCP aparecen en Customize > Plugins.

Los botones de instalación de Cursor y VS Code de arriba siguen funcionando: añaden el mismo servidor stdio npx -y mcp-docker-server que el JSON manual.

Preguntas frecuentes

¿Qué es mcp-docker-server?

El paquete npm de este servidor MCP (nombre del repositorio mcp-server-docker). Se comunica con tu socket local de Docker para enumerar contenedores, seguir registros, ejecutar comandos y gestionar imágenes.

¿Necesito tener Docker Desktop en ejecución?

Sí. El demonio debe estar activo y el proceso MCP debe poder acceder a docker.sock (o a la tubería con nombre de Windows).

¿Es seguro para contenedores de producción?

Trata las operaciones de detener/eliminar/reiniciar como destructivas. Confirma con el usuario antes de cambiar cargas de trabajo en producción.

¿Puedo instalarlo como un Agent Plugin en Cursor?

Sí. Usa ~/.cursor/plugins/local/mcp-server-docker para que la habilidad docker-management incluida se cargue con la configuración de MCP.

¿Necesito claves API?

No. Solo acceso local a Docker.

Desarrollo

git clone https://github.com/ofershap/mcp-server-docker.git
cd mcp-server-docker
npm install
npm test
npm run build

Ver también

Más servidores MCP y herramientas de desarrollo en mi portafolio.

Autor

README creado con README Builder

Licencia

MIT © 2026 Ofer Shapira