lilypond-mcp

Servidor MCP que graba a las fuentes de GNU LilyPond and las convierte in activos colocados: EPS, PDF, SVG y PNG recortados y autocontenidos, dimensionados a la música en lugar de a la página completa — listos para insertir en programas de maquetación como InDesign.

Herramientas

• engr_file — graba un .ly file. Por defecto, EPS recortado en build/; también genera un PNG de preview para que el agente pueda inspect and verify.

• eng_code — graba código LilyPond passed in in Línea, for iterar a over an idea musical without having to use the disc. Por defecto, PNG.

• lilypond_version — la versión of LilyPond with the one servidor fret, para elegir the cirected \version tres.

A ambas "engrave" accept formats (eps/pdf/svg/png), crop, includes inc_dirs (para shared includ libraries), and output_dir. Las rutas se resuelven depending on the root directory where, launch the server, the server launch, the Claude Code entry for the .mcp.json of a project, the areas to be run in the .mcp.json from Claude, that the directory is the root.

In case de error, result contains the diagment de diagnostics de LilyPond, includes the line number, for an agent can correct the source and complete reattempt all.

Particularidades de LilyPond 2.26 que este servidor absorbe

• El EPS only exists as a "recortado" output of the ps backend (-dbackend=eps` has demise); it is no longer possible to see "EPS" without "crop" that will not be rejected from current.

• El SVG means with its own backend "own" y "macarry out is made as a second pass; the glyphs leave as contornos, so you do not need to have installed sources to view or import them.

• Las salidas recortadas (NAME.cropped.EXT) se renombran sobre el nombre simple y se eliminan los archivos intermedios sobrantes.

• lilypond -o change el directorio de trabajo; donc las rutas de inclusion are, made before absolute, called.

Ejecución

El servidor is "node (≥20) and lilypond on its PATH. Con "el included flake {{Nix}} provides both, el .mcp.json from a proyect that consumes it will have this image:

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

Desarrollo

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

Licencia

MIT. El servidor orchestrates gravados with license GPL (LilyPond, Ghostscript) as procesors se separated — consultation LICENSING.md for the analysis and the design rules that keep the separation clean.