Docker MCP Server

by suvarchal
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for managing Docker containers and images, including listing containers and images, running containers with customizable options, stopping and removing containers, and pulling images from registries.

  • Mentioned as an example image that can be pulled and run as a container with port mapping.

Servidor Docker MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para operaciones de Docker. Este servidor permite a Claude y a otros asistentes de IA interactuar con Docker mediante el protocolo MCP.

Nota: Este servidor MCP funciona con comandos CLI de Docker estándar y actualmente no admite operaciones de Docker Compose; otros servidores MCP con docker-compose aún no funcionaban de manera confiable con cline.

Características

  • Lista de contenedores Docker
  • Lista de imágenes de Docker
  • Ejecutar contenedores Docker
  • Detener el funcionamiento de los contenedores
  • Retirar los contenedores
  • Extraer imágenes de Docker de los registros

Instalación

Prerrequisitos

  • Node.js 18 o superior
  • Docker instalado y ejecutándose en su sistema

Instalar desde npm

npm install -g docker-mcp-server

Instalar desde la fuente

  1. Clonar este repositorio
  2. Instalar dependencias:
cd docker-mcp npm install
  1. Construir el proyecto:
npm run build

Uso

Ejecutando el servidor

docker-mcp-server

O si se instala desde la fuente:

npm start

Configurando con Claude

Puede utilizar el script de instalación incluido para configurar automáticamente el servidor Docker MCP con Claude:

npm run install-config

Este script hará lo siguiente:

  1. Detecta tus instalaciones de Claude (Escritorio y/o VSCode)
  2. Actualice los archivos de configuración para incluir el servidor Docker MCP
  3. Configure las rutas correctas para su sistema

Configuración manual

Si prefiere configurarlo manualmente, debe agregar el servidor Docker MCP a su archivo de configuración de MCP:

Para la aplicación de escritorio de Claude (macOS)

Editar ~/Library/Application Support/Claude/claude_desktop_config.json :

{ "mcpServers": { "docker-mcp": { "command": "node", "args": ["/path/to/docker-mcp/dist/index.js"], "disabled": false, "autoApprove": [] } } }
Para Claude en VSCode

Editar ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json :

{ "mcpServers": { "docker-mcp": { "command": "node", "args": ["/path/to/docker-mcp/dist/index.js"], "disabled": false, "autoApprove": [] } } }

Nota: Después de configurar el servidor Docker MCP en VS Code, es posible que deba reiniciar VS Code para que los cambios surtan efecto en Cline. Si experimenta problemas porque el servidor Docker MCP no se reconoce o no funciona correctamente en Cline, intente reiniciar VS Code.

Herramientas disponibles

lista_contenedores

Enumere todos los contenedores Docker.

Parámetros:

  • all (booleano, opcional): muestra todos los contenedores (el valor predeterminado muestra solo los que se están ejecutando)

lista_imágenes

Listar todas las imágenes de Docker.

ejecutar_contenedor

Ejecutar un contenedor Docker.

Parámetros:

  • image (cadena, obligatoria): imagen de Docker para ejecutar
  • name (cadena, opcional): nombre del contenedor
  • detach (booleano, opcional): ejecutar el contenedor en segundo plano
  • ports (matriz de cadenas, opcional): asignaciones de puertos (por ejemplo, ["8080:80"])
  • volumes (matriz de cadenas, opcional): asignaciones de volúmenes (por ejemplo, ["/host/path:/container/path"])
  • env (matriz de cadenas, opcional): variables de entorno (por ejemplo, ["KEY=value"])
  • command (cadena, opcional): comando para ejecutar en el contenedor

contenedor de parada

Detener un contenedor Docker en ejecución.

Parámetros:

  • container (cadena, obligatorio): ID o nombre del contenedor

eliminar_contenedor

Eliminar un contenedor Docker.

Parámetros:

  • container (cadena, obligatorio): ID o nombre del contenedor
  • force (booleano, opcional): fuerza la eliminación del contenedor en ejecución

imagen de extracción

Extraer una imagen de Docker de un registro.

Parámetros:

  • image (cadena, obligatoria): Nombre de la imagen (p. ej., "nginx:latest")

Ejemplo de uso con Claude

Una vez configurado, puedes pedirle a Claude que realice operaciones de Docker:

  • "Ejecutar un contenedor Docker de "hola-mundo""
  • "Enumerar todos los contenedores Docker"
  • "Obtener la última imagen de nginx"
  • Ejecutar un contenedor nginx en el puerto 8080
  • "Detener el contenedor nginx"
  • "Retirar todos los contenedores detenidos"

Mercado MCP

Este servidor Docker MCP está disponible en Cline MCP Marketplace, lo que hace que sea fácil para los usuarios descubrirlo e instalarlo con un solo clic.

El logotipo para el envío a MCP Marketplace se encuentra en el archivo assets/logo.png .

Para obtener más información sobre el Mercado MCP, visite:

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
F
license - not found
-
quality - not tested

Permite que Claude y otros asistentes de IA interactúen con Docker a través del protocolo MCP, lo que habilita la gestión de contenedores e imágenes, incluido el listado, la ejecución, la detención y la extracción de recursos de Docker.

  1. Features
    1. Installation
      1. Prerequisites
      2. Install from npm
      3. Install from source
    2. Usage
      1. Running the server
      2. Configuring with Claude
    3. Available Tools
      1. list_containers
      2. list_images
      3. run_container
      4. stop_container
      5. remove_container
      6. pull_image
    4. Example Usage with Claude
      1. MCP Marketplace
        1. License

          Appeared in Searches

          ID: 6r3y2wmyrw