lilypond-mcp

GNU LilyPond 소스를 배치 가능한 자산으로 변조(engrave)하는 MCP 서버입니다: 전체 페이지가 아니라 음악 크기에 맞춰진 크롭된(cropped) 독립형 EPS, PDF, SVG, PNG를 생성하여 InDesign 같은 페이지 레이아웃 소프트웨어에 바로 넣을 수 있습니다.

Tools

• 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 .mcp.json 항목에서 그 기준 디렉터리는 프로젝트 루트입니다.

실패 시 결과에는 행 번호가 포함된 LilyPond의 진단 정보가 담겨 있어, 에이전트가 소스를 수정한 뒤 다시 시도할 수 있습니다.

이 서버가 흡수하는 LilyPond 2.26 특이점

• EPS는 ps 백엔드의 크롭된 출력으로만 존재합니다(-dbackend=eps는 사라짐). crop 없는 EPS는 처음부터 거부됩니다.

• SVG는 자체 백엔드를 가지며 두 번째 패스로 실행됩니다. 글리프가 외곽선(outline)으로 나오므로, 보거나 가져오기 위해 글꼴을 설치할 필요가 없습니다.

• 크롭된 출력(NAME.cropped.EXT)은 일반 이름으로 이름을 바꿔 덮어쓰며, 남은 중간 파일은 정리됩니다.

• lilypond -o는 작업 디렉터리를 변경하므로, include 경로는 호출 전에 절대 경로로 만듭니다.

실행

서버는 PATH에 node(≥ 20)와 lilypond가 필요합니다. 번들된 Nix 플레이크가 둘 다 제공하므로, 이를 사용하는 프로젝트의 .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를 참조하세요.