@diagrammo/dgmo-mcp

MCP-сервер для отрисовки диаграмм DGMO. Работает с Claude Desktop, Claude Code и любыми инструментами ИИ, совместимыми с MCP.

Инструменты

preview_diagram

Отрисовывает одну или несколько диаграмм DGMO в формат SVG и открывает автономную HTML-страницу в браузере по умолчанию. Страница включает переключатель светлой/темной темы и адаптивную верстку SVG.

Одна диаграмма отображается как простая страница предпросмотра. Несколько диаграмм создают макет в стиле отчета с оглавлением (если разделов больше 3). Если некоторые диаграммы не удалось отрисовать, успешные будут показаны вместе с заглушками об ошибках для неудачных.

generate_report

Создает оформленный многосекционный HTML-отчет и опционально открывает его в браузере. Включает заголовок, опциональный подзаголовок, автоматически генерируемое оглавление, описания для каждого раздела и нижний колонтитул с отметкой времени. Подходит для объединения анализа проекта в документ, которым можно поделиться.

Related MCP server: drawio

Настройка

Claude Code

Добавьте в файл .claude/settings.local.json вашего проекта:

{
  "mcpServers": {
    "dgmo": {
      "command": "npx",
      "args": ["-y", "@diagrammo/dgmo-mcp"]
    }
  }
}

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dgmo": {
      "command": "npx",
      "args": ["-y", "@diagrammo/dgmo-mcp"]
    }
  }
}

После сохранения перезапустите Claude Desktop. Инструменты появятся автоматически.

Разработка

pnpm install
pnpm build
pnpm typecheck

Для итеративной разработки с использованием неопубликованного пакета @diagrammo/dgmo, расположенного в ../dgmo, переопределите зависимость, разрешенную npm, с помощью символической ссылки рабочей области после установки:

pnpm install
pnpm link ../dgmo   # symlink node_modules/@diagrammo/dgmo → ../dgmo
pnpm --filter @diagrammo/dgmo build   # ensure dist/ is up to date

Команда pnpm install удалит ссылку, поэтому при изменении зависимостей снова выполните pnpm link ../dgmo.

Релизы

Релизы управляются через теги в .github/workflows/release.yml:

1. Увеличьте версию во всех трех файлах (должны совпадать в точности — рабочий процесс проверяет это):

   • package.json → version

   • manifest.json → version

   • server.json → version и packages[0].version

2. Закоммитьте и создайте тег:

   git commit -am "Release vX.Y.Z"
   git tag vX.Y.Z
   git push && git push --tags

3. Рабочий процесс выполняет проверку типов + сборку, публикует в npm с подтверждением происхождения (provenance), упаковывает .mcpb, публикует в реестр MCP через GitHub OIDC и прикрепляет .mcpb к релизу на GitHub.

Необходимые секреты

• NPM_TOKEN — гранулярный токен доступа npm с правами записи для @diagrammo/*. Settings → Secrets and variables → Actions → New repository secret.

Авторизация в реестре MCP использует GitHub OIDC автоматически (токен не требуется), так как репозиторий находится в организации diagrammo, а пространство имен сервера — io.github.diagrammo/*.