d2-mcp

MCP-Server für die D2-Diagrammsprache. Kompilieren, validieren und erkunden Sie D2-Diagramme von jedem MCP-kompatiblen KI-Assistenten aus.

Verwendet die native D2-CLI-Binärdatei (wird automatisch im Docker-Image installiert), um Diagramme in SVG und PNG zu kompilieren.

Werkzeuge

Ressourcen

Lokale Entwicklung

Voraussetzungen

• Node.js 22+

• D2 CLI — Installation über d2lang.com oder setzen Sie die Umgebungsvariable D2_PATH auf den Pfad der Binärdatei.

• Symbole (optional) — Führen Sie scripts/download-icons.sh ./icons aus und setzen Sie dann ICONS_DIR=./icons, um die lokale Symbolauflösung zu aktivieren. Ohne dies werden Symbol-URLs unverändert an die D2-CLI weitergeleitet.

npm install
npm run build
npm start

Für die Entwicklung mit automatischem Neuladen:

npm run dev

Der Server startet standardmäßig auf Port 3000 (kann mit der Umgebungsvariable PORT überschrieben werden).

• Gesundheitsprüfung: GET /health

• MCP-Endpunkt: POST /mcp (Streamable HTTP-Transport)

Umgebungsvariablen

Bereitstellung (Render)

Dieses Projekt enthält ein Dockerfile und einen render.yaml-Bauplan für die Bereitstellung mit einem Klick auf Render. Das Docker-Image installiert automatisch die D2-CLI-Binärdatei und lädt alle Symbole zur Build-Zeit herunter.

1. Pushen Sie dieses Repository zu GitHub

2. Erstellen Sie in Render einen neuen Blueprint und verbinden Sie Ihr Repository

3. Render erkennt render.yaml automatisch und führt die Bereitstellung durch

Oder erstellen Sie manuell einen Web Service mit:

• Umgebung: Docker

• Pfad für Gesundheitsprüfung: /health

• Plan: Kostenlos

Verbindung zum MCP-Server

Nach der Bereitstellung konfigurieren Sie Ihren MCP-Client für die Verbindung über Streamable HTTP:

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

Ersetzen Sie die URL durch Ihre tatsächliche Render-Service-URL (oder http://localhost:3000/mcp für lokal).

Optionen für das Kompilier-Werkzeug

Lizenz

MIT