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

Related MCP server: Docker MCP Server

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

3. 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:

• Repositorio del mercado MCP

• Presentamos el Mercado MCP

Licencia

Instituto Tecnológico de Massachusetts (MIT)