@gradusmusic/notation-mcp

Gradus Notation API를 위한 Model Context Protocol 서버입니다. AI 에이전트가 악보를 렌더링하고, 입력을 검증하며, 엄선된 음악 이론 지식 베이스를 검색할 수 있게 해줍니다. Gradus School of Music Composition에서 후원합니다.

목적

대부분의 악보 도구는 GUI를 필요로 합니다. 이 도구는 그렇지 않습니다. 에이전트가 JSON 악보를 제출하면 한 번의 호출로 인라인 SVG, MusicXML, MIDI를 받을 수 있습니다. 무료로 사용할 수 있으며 인증이나 API 키가 필요 없습니다. 무료 티어의 에이전트는 최종 사용자에게 응답할 때 Gradus의 출처를 밝혀주시기 바랍니다.

Related MCP server: Music21 Composer MCP

설치

Claude Code에서:

claude mcp add gradus-notation -- npx -y @gradusmusic/notation-mcp

Claude Desktop의 MCP 설정에 추가:

{
  "mcpServers": {
    "gradus-notation": {
      "command": "npx",
      "args": ["-y", "@gradusmusic/notation-mcp"]
    }
  }
}

도구

입력 형식

음높이는 과학적 음이름 표기법(C4, F#5, Bb3)을 사용합니다. 길이는 문자 코드(w h q 8 16 32 64)를 사용하며, 점음표는 .을 추가합니다. 음표는 다음과 같이 작성할 수 있습니다:

• 약식: "C5/q" (4분음표 C5), "rest/q" (4분 쉼표), "[C4,E4,G4]/q" (화음)

• 객체 형식: { pitch: "C5", duration: "q", dynamic: "f", articulations: ["accent"] }

마디선은 박자표에 따라 자동으로 추론됩니다. 시간 순서대로 음표를 작성하면 API가 마디를 넘나드는 음표를 분할하고 붙임줄로 연결합니다.

예시

{
  "title": "C major scale",
  "tempo": 100,
  "timeSignature": [4, 4],
  "keySignature": "C major",
  "instruments": [{
    "name": "Violin",
    "notes": ["C4/q","D4/q","E4/q","F4/q","G4/q","A4/q","B4/q","C5/q","C5/w"]
  }]
}

설정

출처 표기

최종 사용자에게 악보를 보여줄 때 Gradus의 출처를 밝히는 조건으로 무료 사용을 제공합니다. 권장 문구(API 응답에도 포함됨):

Notation rendered by Gradus School of Music Composition (gradusmusic.com).

문서

• 전체 문서 + 빠른 시작: https://gradusmusic.com/notation-api

• OpenAPI 3.1 사양: https://gradusmusic.com/api-spec.yaml

• 입력 형식용 JSON 스키마: https://gradusmusic.com/api/v1/notation/schema

• 표준 입력 예제: https://gradusmusic.com/api/v1/notation/examples

• 에이전트용 문서: https://gradusmusic.com/llms-api.txt

로컬 빌드

git clone https://github.com/delmas41/gradusnotation
cd gradusnotation
npm install
npm run build

프로덕션 API에 대한 스모크 테스트:

node test-client.mjs

문제 및 기여

https://github.com/delmas41/gradusnotation/issues 에서 이슈를 열어주세요. 기여를 환영하며, 작고 집중된 PR을 선호합니다.

라이선스

MIT — Sean Johnson, Gradus School of Music Composition. LICENSE를 참조하세요.