Skip to main content
Glama
deenesjakoruzh
ryanmccauley

d2-mcp

by ryanmccauley
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Herramienta

Descripción

compile

Código fuente D2 → SVG/PNG. Admite motores de diseño, temas, modo boceto, temas oscuros, segmentación de tableros múltiples y más.

validate

Comprueba la sintaxis de D2 sin renderizar. Devuelve el estado de validez y detalles de error.

list_themes

Lista todos los temas D2 disponibles con sus IDs (claros y oscuros).

list_layouts

Lista los motores de diseño disponibles (dagre, elk).

list_icons

Explora iconos de icons.terrastruct.com por categoría (AWS, GCP, Azure, K8s, dev, essentials, tech).

Related MCP server: PlantUML MCP Server

Recursos

Recurso

Descripción

d2://syntax-reference

Referencia completa de la sintaxis del lenguaje D2 en markdown.

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

Variable

Por defecto

Descripción

PORT

3000

Puerto del servidor HTTP

D2_PATH

d2

Ruta al binario CLI de D2 (resuelto mediante PATH por defecto)

ICONS_DIR

./icons

Directorio que contiene iconos SVG descargados para resolución local

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

Parámetro

Tipo

Descripción

code

string

Código fuente D2 (obligatorio)

layout

"dagre"

"elk"

Motor de diseño (por defecto: dagre)

sketch

boolean

Modo de boceto dibujado a mano

themeID

integer

ID del tema (ver list_themes)

darkThemeID

integer

ID del tema en modo oscuro

pad

integer

Relleno en píxeles (por defecto: 100)

center

boolean

Centrar SVG en el viewbox

scale

number

Factor de escala (por defecto: ajustar a la pantalla)

target

string

Tablero de destino para diagramas de múltiples tableros

animateInterval

integer

Intervalo de animación (ms) para SVG de múltiples tableros

noXMLTag

boolean

Omitir declaración XML para incrustación HTML

Licencia

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Mermaid Chart MCP

    pickstar-2002
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to generate and render Mermaid diagrams (flowcharts, sequence diagrams, etc.) as PNG/SVG images with local file saving and HTTP access URLs. Supports batch processing and intelligent caching for efficient diagram creation.
    1
    15 npm
    1
    MIT

  • FlowZap MCP Server

    flowzap-xyz
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to create and validate workflow diagrams using FlowZap's text-based DSL. Generates shareable playground URLs for visualizing flowcharts, process diagrams, and CI/CD pipelines through natural language descriptions.
    7
    104 npm
    5
    MIT

  • DiagramMCP

    LelonDelonMelon
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables the dynamic generation of various software development diagrams, such as flowcharts, sequence diagrams, and architecture diagrams, using Mermaid syntax. It includes tools for diagram validation and provides instructions for exporting results to multiple formats including SVG and PNG.
    -