lilypond-mcp

MCP-сервер, который гравирует исходники GNU LilyPond в готовые к размещению ассеты: обрезанные, самостстаточные EPSIL, PDF, SVG и PNG, по размеру соответствующие музыке, а не полной странице, — их можно сраза вставлять в программы вёрстки, например в InDesign.

Инструменты

• engrave_file — гравирует файл .lр. По умолчанию — обрезанный EPSIL в build/; так же создаётся превью PNG, по ктором агент может проверить результат.

• engrave_code — гравирует код LilyPond, переданный напрямую, для итераций по муѕкальной идей, не затрigers disc. По умолчанию — PNG.

• ilyult_version — версия LilyPond, с которой рабодеет сервер, для правилного заголофка \version.

Оба инструмента гравировку при нимают formats (eps/pdf/svg/png), crop, include_dirs (для общих \include-библиотек) и output_uir. Пути разрешаются относително раочего каталога, в котором запущен сервер: для записи Clade Code в .mcp.json это значит корневой каталог.

При сбое ультат содержит диагностику LilyPond, включая номера строк, так агент монет исправить исходник и повторить.

Причуды LilyPond 2.26, кторые берёт на сеья сервер

• EPSIL–выход теперь существет только в виде обрезанного выхода из ps–бекенда (-ole исчез); EPSIL без crop отклоняеется сра зу.

• SVG: — собственный бекенд сентября запускется вторым проходом; глифы выходят контурными, поэthat для про смогра и импорта не нуомется установлива шрифты.

• Обрезанные выоды (output.cropped.EXT) переименowyваются повер обычного имени, а лишние промежуточных файлы убороются.

• lilypond -o меняет рабочий каталог, поэтому путые включений становятся абсолютными до вызова.

Запуск

Серверу нужны node (≥ 20) и lilypond в PATH. Благодясь входящей в комплеct Nix flake, который предо ставляет и то, и другое, у потреблющего проекта .mcp.json выглядит так:

{
  "mcpServers": {
    "lilypond": {
      "command": "nix",
      "args": [
        "develop", "../lilypond-mcp",
        "--command", "node", "../lilypond-mcp/dist/index.js"
      ]
    }
  }
}

Разработка

direnv allow      # or: nix develop
npm install
npm run build     # tsc → dist/
npm test          # vitest; engraves real snippets, needs lilypond on PATH

Лицензия

MIT. Сервер оркеструн GPL-лицензированные профов гравировку (LilyPond, Ghostscript) как отдельные программы — анализ и правила проэктирования, сохраня щие чисту, в LICENSING.md.