d2-mcp

Servidor MCP para el lenguaje de diagramas D2. Compila, valida y explora diagramas D2 desde cualquier asistente de IA compatible con MCP.

Utiliza el binario CLI nativo de D2 (instalado automáticamente en la imagen de Docker) para compilar diagramas a SVG y PNG.

Herramientas

Recursos

Desarrollo local

Requisitos previos

• Node.js 22+

• D2 CLI — instálalo desde d2lang.com o establece la variable de entorno D2_PATH a la ubicación del binario.

• Iconos (opcional) — ejecuta scripts/download-icons.sh ./icons y luego establece ICONS_DIR=./icons para habilitar la resolución de iconos local. Sin esto, las URLs de los iconos se pasan al CLI de D2 tal cual.

npm install
npm run build
npm start

Para desarrollo con recarga automática:

npm run dev

El servidor se inicia en el puerto 3000 por defecto (se puede sobrescribir con la variable de entorno PORT).

• Comprobación de estado: GET /health

• Endpoint MCP: POST /mcp (transporte HTTP transmitible)

Variables de entorno

Despliegue (Render)

Este proyecto incluye un Dockerfile y un blueprint render.yaml para el despliegue con un solo clic en Render. La imagen de Docker instala automáticamente el binario CLI de D2 y descarga todos los iconos durante la compilación.

1. Envía este repositorio a GitHub

2. En Render, crea un nuevo Blueprint y conecta tu repositorio

3. Render detectará automáticamente render.yaml y realizará el despliegue

O crea manualmente un Web Service con:

• Entorno: Docker

• Ruta de comprobación de estado: /health

• Plan: Gratuito

Conexión al servidor MCP

Una vez desplegado, configura tu cliente MCP para conectarse mediante HTTP transmitible:

{
  "mcpServers": {
    "d2": {
      "url": "https://your-service.onrender.com/mcp"
    }
  }
}

Reemplaza la URL con la URL real de tu servicio en Render (o http://localhost:3000/mcp para local).

Opciones de la herramienta de compilación

Licencia

MIT