用途
Gradus Notation 是一套面向 AI 智能体的音乐记谱工具，以 MCP 服务器和 REST API 形式提供。它让智能体无需图形界面即可提交 JSON 乐谱，并在一次调用中获取内联 SVG、MusicXML 和 MIDI 输出。工具由 Gradus（面向家庭学校的音乐作曲课程，gradusmusic.com）赞助，属于通用开发者工具，并非课程本身，也不限于教育用途。目标用户包括作曲助手、音乐学与语料库研究、需要渲染示例的理论问答、MIDI 流水线、雕版质量检查、游戏和文档等任何涉及音乐的智能体或应用。
主要能力
一次安装包含三个具名工具：
- Gradus Notation：将 JSON 乐谱渲染为内联 SVG、MusicXML 和 MIDI，并提供预检验证（notation_render、notation_validate）。
- Gradus Harmonic Analyzer：整份乐谱分析，涵盖罗马数字、调性与转调、终止式、持续音和织体，由原生 TypeScript MaestroAnalyzer 引擎驱动，无 music21 依赖、无需 Python 或额外服务器，提供 theory_analyze_score 及 theory_* 工具，并有独立 TypeScript 库 gradus-analyst 发布于 npm。
- Gradus Engraver：依据 Gradus 雕版规则手册中可引用的 GE 编码规则检查乐谱雕版（engraving_check）。每条规则区分惯例（规则本身）、权威（论著说法，引用到章节，且仅引用公有领域论著，如 Fux、Rameau、Kirnberger、Fenaroli、Riepel、Prout）与内部裁定（Gradus 在来源分歧时的取舍）。规则 ID 永久，规则文本采用 CC BY 4.0，可引用 citation 字段。错误 ID 会返回 404 及近似匹配 ID，便于一次调用内修正。
此外还提供音高工具、音域验证、等音异名改写，以及包含 444 条规则的雕版检查器。Gradus 声部进行参考（GVL 编码）以公有领域论著为每个模式提供章节级引用，其 realization.voices 字段可直接交给 notation_render 雕版。Gradus 数字低音语料库包含低音、数字及四声部模型实现（机器检查声部进行），覆盖从根位三和弦到八度规则、终止式公式、延留音、属七、模进、小调、持续音、Riepel 图式、转调与半音、无数字低音与减缩等阶段。所有练习为原创，语料库采用 CC BY 4.0，练习 ID 与阶段 slug 永久有效；givenBass 是展示给学生的内容，realization 是保留的答案。
使用方式
在 Claude Code 中安装；在 Claude Desktop 的 MCP 配置中添加即可。免费使用无需认证、无 API 密钥。构建本地版本可对生产 API 进行冒烟测试。engraving_check 闭环流程为：生成记谱、检查、修正发现的问题。应尽量传入本地文件路径，服务器直接读取，乐谱无需以 base64 经过模型上下文。在信任空发现列表前，需阅读 coverage.unchecked，其中列出检查器无法验证的内容。
音高采用科学记谱法（C4、F#5、Bb3），时值使用字母代码（w h q 8 16 32 64，可加 . 表示附点）。音符可写成简写（如 "C5/q"、"rest/q"、"[C4,E4,G4]/q"）或对象形式（如 { pitch: "C5", duration: "q", dynamic: "f", articulations: ["accent"] }）。小节线由拍号推断，按时间顺序写入音符，API 会拆分并连接跨小节线的音符。
免费使用需在向最终用户展示记谱时注明 Gradus，建议措辞（每次响应也会返回）为：Notation rendered by Gradus School of Music Composition (gradusmusic.com)。
适用场景
作曲助手、音乐学与语料库研究、需要渲染示例的理论问答、MIDI 流水线、雕版质量检查、游戏、文档等任何涉及音乐处理的智能体或应用。当用户分享作品时，这些工具能让反馈有据可依：评论引用所测量的内容，类型评分指向具体音符，语料库搜索以引用回答“给我一个真实例子”。
限制
- 该工具为通用开发者工具，并非 Gradus 课程本身。
- 雕版检查依赖规则手册，coverage.unchecked 中列出的内容无法验证。
- 免费层要求注明 Gradus。
- 其他限制暂未提供。
文档与资源
完整文档与快速开始：https://gradusmusic.com/notation-api OpenAPI 3.1 规范：https://gradusmusic.com/api-spec.yaml 输入格式 JSON Schema：https://gradusmusic.com/api/v1/notation/schema 规范输入示例：https://gradusmusic.com/api/v1/notation/examples 面向智能体的文档：https://gradusmusic.com/llms-api.txt 问题与贡献：https://github.com/delmas41/gradusnotation/issues 许可证：MIT，作者 Sean Johnson, Gradus School of Music Composition。
