d2-mcp

MCP-сервер для языка диаграмм D2. Компилируйте, проверяйте и изучайте диаграммы D2 из любого MCP-совместимого ИИ-ассистента.

Использует нативный бинарный файл D2 CLI (автоматически устанавливаемый в Docker-образ) для компиляции диаграмм в форматы SVG и PNG.

Инструменты

Ресурсы

Локальная разработка

Предварительные требования

• Node.js 22+

• D2 CLI — установите с d2lang.com или установите переменную окружения D2_PATH на путь к бинарному файлу.

• Иконки (опционально) — выполните scripts/download-icons.sh ./icons, затем установите ICONS_DIR=./icons для включения локального разрешения иконок. Без этого URL-адреса иконок передаются в D2 CLI «как есть».

npm install
npm run build
npm start

Для разработки с автоматической перезагрузкой:

npm run dev

Сервер запускается на порту 3000 по умолчанию (можно переопределить переменной окружения PORT).

• Проверка работоспособности: GET /health

• MCP-эндпоинт: POST /mcp (потоковый HTTP-транспорт)

Переменные окружения

Развертывание (Render)

Этот проект включает Dockerfile и шаблон render.yaml для развертывания в один клик на Render. Docker-образ автоматически устанавливает бинарный файл D2 CLI и загружает все иконки во время сборки.

1. Отправьте этот репозиторий на GitHub

2. В Render создайте новый Blueprint и подключите свой репозиторий

3. Render автоматически обнаружит render.yaml и выполнит развертывание

Или вручную создайте Web Service с параметрами:

• Environment: Docker

• Health Check Path: /health

• Plan: Free

Подключение к MCP-серверу

После развертывания настройте свой MCP-клиент для подключения через потоковый HTTP:

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

Замените URL на фактический URL вашего сервиса Render (или http://localhost:3000/mcp для локальной версии).

Параметры инструмента Compile

Лицензия

MIT