@gradusmusic/notation-mcp

Gradus Notation API 的模型上下文协议 (MCP) 服务器。允许 AI 代理渲染乐谱、验证输入并搜索精选的乐理知识库 — 由 Gradus 音乐作曲学校赞助。

为什么选择它

大多数乐谱工具都需要图形用户界面 (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"（四分音符 C5）、"rest/q"（四分休止符）、"[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 的每次响应中也会返回此内容）：

乐谱由 Gradus 音乐作曲学校 (gradusmusic.com) 渲染。

文档

• 完整文档 + 快速入门：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

本地构建

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 音乐作曲学校。请参阅 LICENSE。