@gradusmusic/notation-mcp

Gradus Notation API用のModel Context Protocolサーバーです。AIエージェントが楽譜をレンダリングし、入力を検証し、厳選された音楽理論ナレッジベースを検索できるようにします。Gradus School of Music Composition提供。

目的

ほとんどの楽譜作成ツールはGUIを必要としますが、本ツールは不要です。エージェントはJSONスコアを送信するだけで、インラインSVG、MusicXML、MIDIを1回の呼び出しで取得できます。無料で使用でき、認証や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 でIssueを作成してください。貢献を歓迎します。小規模で焦点を絞ったPRを推奨します。

ライセンス

MIT — Sean Johnson, Gradus School of Music Composition. LICENSEを参照してください。