lilypond-mcp

MCP サーバーです。GNU LilyPond のソースを配置可能なアセットに彫刻します。フルページではなく音楽に合わせたサイズで、切り出し済み・自己完結の EPS、PDF、SVG、PNG を生成し、InDesign などのページレイアウトソフトウェアにそのまま配置できるようにします。

ツール

• engrave_file — .ly ファイルを彫刻します。デフォルトは build/ への切り出し済み EPS で、さらにエージェントが結果を確認できるプレビュー PNG も生成します。

• engrave_code — インラインで渡された LilyPond のコードを彫刻します。ディスクに触れずに音楽のアイデアを反復するためのものです。デフォルトは PNG です。

• lilypond_version — サーバーが彫刻に使う LilyPond のバージョンを返します。適切な \version ヘッダーを選ぶために使います。

どちらの彫刻ツールも formats (eps/pdf/svg/png)、crop、include_dirs (共有 \include ライブラリ用)、output_dir を指定できます。パスはサーバーが起動された作業ディレクトリを基準に解決されます。Claude Code の .svc.json エントリでは、その作業ディレクトリがプロジェクトルートのルートです。

失敗した場合は、行番号入りの LilyPond の診断情報が結果と共に返されるため、エージェントがソースを修正して再試行できます。

当サーバーが吸収する LilyPond 2.26 の注意点

• EPS は ps バックエンドの切り出し出力としてだけ存在します (-backend=eps は廃止済み)。cрой` なしの EPS は先に拒否されます。

• SVG には専用のバックエンドがあり、2 つ目のパスとして実行されます。グリフはアウトラインとして出力されるため、表示や取り込みにフォントのインストールは不要です。

• 切り出し済みの出力 (NAME.cropped.EXT) は、後続の名前でリネームされ、後れた中間ファイルはクリーンアプされます。

• lilypond -o は作業ディレクトリを変更するため、呼び出、し前に include パスを絶対パスへ変換します。

実行

サーバーには node (20 以上) と lilypond が PATH に必要です。バ ンドルされた 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、Ghostcript) を独立したプログラムとしてオーケストレートします。境界を明確に保つための分析と設計ルールは、LICENSING.md を参照してください。