Enables generating, rendering, and editing MuseScore-compatible musical scores by compiling a text notation DSL into MusicXML and driving the MuseScore CLI to export formats such as .mscz, PDF, PNG, SVG, MIDI, and MP3. Also supports inspecting score metadata, transposing, extracting parts, editing existing scores, and joining multiple scores.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EasyMuseMCP Compose Ode to Joy for piano in G major and export it as PDF and MIDI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
用一句话（或一次工具调用）直接写出真正的 MuseScore 乐谱。
EasyMuseMCP 把「紧凑的文本记谱」编译成 MusicXML，再驱动 MuseScore 的命令行（无窗口）导出 .mscz / .pdf / .png / .svg / .midi / .mp3。它同时提供两个入口：
CLI（msc） —— 人和脚本都能用
MCP server —— 让 Claude / Cursor / DSH 等 AI 客户端把它当成内置工具调用
不需要打开 MuseScore 窗口，不需要装 QML 插件，不需要 WebSocket。纯 Node.js，零第三方依赖。
Related MCP server: musescore-mcp
社区里已有的 MuseScore MCP（比如 mcp-musescore 一类）基本都走 GUI + QML 插件 + WebSocket 路线：必须让 MuseScore 窗口开着、手动进 Plugins 启用插件、靠移动光标一个个敲音符。
这条路子的问题很明显：不能批量、不能无人值守、出错就卡在光标位置、也没法在服务器上跑。
EasyMuseMCP 换了个底层：MuseScore 自带的无窗口转换模式才是一台真正的「渲染引擎」——你只要把 MusicXML 交给它，它就能排出一份正经乐谱。于是问题变成「怎么把人类/模型想写的音乐，可靠地变成 MusicXML」，剩下的都交给 MuseScore。
实测：单页钢琴谱从文本到 PDF/PNG/MIDI/MP3 约 2–6 秒。
文本 DSL ──解析──> 乐谱模型 ──生成──> MusicXML ──MuseScore CLI──> mscz / pdf / png / midi / mp3
│ ▲
├─ 小节时值校验 │
├─ 连音线/歌词/反复 └── 编辑层：改标题、速度、调号、移调、增删小节、加歌词
└─ 演奏法/装饰音/踏板关键设计：
模块 | 作用 |
| 解析文本记谱，做小节时值校验（不够补休止、超了报错并给出小节号） |
| 生成 MusicXML 4.0，处理调号、连音线、歌词、反复、装饰音、踏板、版面 |
| 封装 MuseScore CLI：定位程序、导出、抽 JSON、收集产物 |
| 在 MusicXML 上做小节/元素级编辑，用于改已有乐谱 |
| 纯文本移调，对任意 MuseScore 可读格式生效 |
| 零依赖 stdio MCP server（手写 JSON-RPC） |
依赖 | 版本 | 说明 |
Node.js | ≥ 18 | 用到了 ESM 与 |
MuseScore | 3.x / 4.x | 提供无窗口渲染，必须安装（推荐 MuseScore 4） |
MuseScore 会被自动探测，常见路径：
macOS：/Applications/MuseScore 4.app/Contents/MacOS/mscore
Linux：/usr/bin/mscore、/usr/local/bin/mscore
Windows：请把 MSCORE_BIN 设为 MuseScore4.exe 的完整路径
# 自检
node bin/msc.js doctor
# MuseScore binary : /Applications/MuseScore 4.app/Contents/MacOS/mscore
# version : 4.7.4
# status : ready自定义路径：export MSCORE_BIN=/path/to/mscore
git clone https://github.com/Ranger013/EasyMuseMCP.git
cd EasyMuseMCP
node bin/msc.js doctor想全局使用 msc 命令：
npm link # 之后可以直接敲 msc或直接从仓库跑（无需安装）：
npx github:Ranger013/EasyMuseMCP doctor写一个 song.msc：
title: 小星星
composer: 法国民谣
key: C
time: 4/4
tempo: 100
part "Piano" instrument=piano staves=2 clefs=treble,bass
voices 1
C5/4 C5/4 G5/4 G5/4 | A5/4 A5/4 G5/2 |
voices 2
C3/2 C3/2 | F2/2 C3/2 |一条命令出全套：
node bin/msc.js compose song.msc --formats pdf,png,mscz,midi,mp3 --out out/song✔ 小星星 — 2 measures, 12 notes, 1 part(s)
musicxml out/song/song.musicxml
mscz out/song/song.mscz
pdf out/song/song.pdf
png out/song/song-1.png
midi out/song/song.midi
mp3 out/song/song.mp3其它常用命令：
msc ref # 打印完整记谱语法
msc inspect out/song/song.mscz # 读标题/调号/拍号/速度/声部/页数/时长
msc transpose song.mscz --semitones -2
msc parts song.mscz # 按声部导出分谱
msc open song.mscz # 在 MuseScore 里打开继续手改server 走 stdio，所以配置里给一个启动命令即可。
Claude Desktop / Claude Code / Cursor 等（JSON）
{
"mcpServers": {
"easymuse": {
"command": "node",
"args": ["/绝对路径/EasyMuseMCP/server.js"]
}
}
}DSH（~/.dsh/profiles/<profile>/cordis.patch.yml）
- insert:
- name: "@deepseek-ai/dsh-mcp-client"
config:
transport: stdio
serverName: musescore # 工具前缀 → mcp__musescore__*
command: /usr/local/bin/node
args: ["/绝对路径/EasyMuseMCP/server.js"]
toolCallTimeoutMs: 180000
failOnStartupError: false接入后模型会先调 musescore_notation_reference 读语法，然后用 musescore_compose 写谱、用 musescore_view 把渲染结果当图片看回来，自己检查排版。
共 11 个工具：
工具 | 用途 |
| 检查 MuseScore 是否可用、版本号 |
| 返回记谱语法速查表（模型先读这个） |
| 文本 → 乐谱，返回产物路径 + 音乐摘要 + 警告 |
| 任意乐谱转格式 / 单页导出 / 套用 |
| 渲染某页并以图片返回，用于自查排版 |
| 读取元数据 |
| 整谱移调 |
| 按声部导出分谱 |
| 按操作列表修改已有乐谱（见下） |
| 多份乐谱首尾相接 |
| 在 MuseScore GUI 中打开 |
完整版：msc ref。下面是最常用的部分。
title: 欢乐颂 subtitle: Ode to Joy
composer: 贝多芬 key: G time: 4/4 tempo: 120
systems: 4 page: A4 margins: 15 scaling: 7
part "Piano" instrument=piano staves=2 clefs=treble,bass
voices 1
|: E4/4 E4/4 F4/4 G4/4 | G4/4 F4/4 E4/4 D4/4 :|
voices 2
%ped [C3 E3 G3]/1 | %ped-up [G2 B2 D3]/1 |写法 | 含义 |
| 音名+八度 |
| 升 / 降 / 还原 |
| 附点 / 双附点 |
| 和弦（空格或逗号分隔） |
| 休止符 / 整小节休止 |
| 连音线（自动配对，可跨小节） |
| 圆滑线 |
| 三连音（也支持 T5 / T7） |
| 倚音； |
| 演奏法：stacc / staccissimo / accent / tenuto / marcato / breath / upbow / downbow |
| 装饰音：trill / mordent / inv-mordent / turn / inv-turn / tremolo |
| 延长记号 |
| 力度：pp p mp mf f ff sf fp |
| 歌词（词尾 |
| 延音踏板 |
| 渐强 / 渐弱发夹 |
| 中途变拍号 / 变调 / 变速 |
| 小节线 / 终止线 / 反复记号 |
版面指令：page（A4/A5/A3/letter/210x297）、margins（毫米，1/2/4 个数字）、scaling（每谱间毫米数，调大即整体放大）、staff-distance、system-distance、systems（每行小节数）、style（复用 MuseScore 导出的 .mss）。
小节必须填满：不足会自动补休止并告警，超出会告警并指出小节号。这是最主要的自查手段。
msc edit / musescore_edit 支持 11 个操作，作用对象可以是任何 MuseScore 能打开的文件（.mscz、.musicxml、.mid、.gp …）：
操作 | 参数 | 说明 |
|
| 改元数据，缺的会自动新建 |
|
| 改速度（可指定从第几小节起） |
|
| 改调号 |
|
| 改拍号（只改拍号，不重排已有音符时值） |
|
| 按小节范围移调 |
|
| 删小节并重编号 |
|
| 复制乐段（自动剥掉谱号/拍号/速度等结构元素） |
|
| 追加空小节 |
|
| 按音符顺序填歌词 |
|
| 换乐器 |
|
| 重排每行小节数（0 = 交给 MuseScore） |
示例：
# 加速、改副标题、把前 4 小节复制一遍、再重排成每行 4 小节
msc edit song.mscz --ops '[
{"op":"set_tempo","tempo":108},
{"op":"set_metadata","subtitle":"加长版"},
{"op":"duplicate_measures","from":1,"to":4},
{"op":"set_systems","measures":4}
]'
msc join a.mscz b.mscz --name medley # 两首接成一首msc doctor 环境自检
msc ref 记谱语法
msc compose <file.msc|-> [--formats a,b] [--out dir] [--name slug] [--res dpi] [--trim px] [--style x.mss]
msc render <score> [--formats a,b] [--out dir] [--page n] [--style x.mss]
msc inspect <score> 元数据
msc transpose <score> --semitones N 移调
msc parts <score> 导出分谱
msc open <score> 用 MuseScore 打开
msc set <score> [--title|--subtitle|--composer|--lyricist|--tempo|--key|--time] [--at-measure N]
msc cut <score> --measures 5-8
msc dup <score> --measures 1-4 [--times 2]
msc pad <score> --count 4
msc lyrics <score> --text "一 闪 一 闪" [--staff 1] [--verse 1] [--part 1]
msc instr <score> --instrument violin [--part 1]
msc systems <score> --per-line 4
msc join <a> <b> [...]
msc edit <score> --ops '<JSON 数组>'格式：musicxml mscz pdf png svg midi mp3。
这些都是在真实 MuseScore 4.7 上撞出来的，写下来省得你再撞一遍：
反复记号必须写进每个声部。只要有一个声部缺反复小节线，MuseScore 会把整份谱的反复静默丢弃。所以反复提升到全谱级，每个 part 都发一遍。
前反复要写在上一小节末尾（<barline location="right"> + bar-style heavy-light），写在下一小节开头会被忽略。
标题必须用 <credit> + <credit-type>。MuseScore 把 movement-title 当大标题，而普通 <credit> 会顶掉标题；只有带 credit-type: title/subtitle 才生成正确的两行。
调号内的音不要画临时记号。G 大调里的 F# 若照写 <accidental>sharp</accidental> 会多一个升号；要按五度圈判断，只在偏离调号时输出。
变拍/变调不能顺带重打速度记号——否则每个变换小节都会多印一个 ♩=。
复制小节要剥掉结构元素：<attributes>、<print>、<metronome> 都在小节里，复制时不清理，谱中间会冒出多余的谱号/拍号/速度。
往返后的 XML 标签带属性：<metronome parentheses="no">、<sound tempo="90" dynamics="..."/>，正则必须容忍属性，否则编辑操作会静默失效。
-T 0 裁剪不可靠：裁剪边界可能比内容窄，把右侧音符切掉。默认整页导出。
PNG/SVG 输出名带页码：-o x.png 实际得到 x-1.png。
--score-parts 不落盘：各分谱以 base64 塞进 JSON 的 partsBin 打到 stdout。
--score-meta 的 stdout 混着日志，要从第一个 { 起做括号配平再 JSON.parse。
退出码不可信：MuseScore 有时写完文件后崩溃（macOS 上常见 Abort trap: 6）。判定成功以「产物存在且非空」为准。
反复段落的一二房（volta）、琶音记号、滑音、自定义符头暂未支持。
中途变拍只改拍号，不会重排已有音符的时值。
编辑粒度是「小节 / 元素」，没有逐音符拖拽式编辑。
不支持在已打开的 MuseScore 窗口里实时改谱（那需要 GUI 插件 + WebSocket，是另一套架构）。
不提供音频转谱（不能听 MP3 扒谱）。
EasyMuseMCP/
├── bin/msc.js CLI 入口
├── server.js MCP server（stdio，零依赖）
├── lib/
│ ├── frac.js 分数运算（时值不碰浮点）
│ ├── dsl.js 文本记谱解析 + 小节校验
│ ├── musicxml.js 乐谱模型 → MusicXML
│ ├── mscore.js MuseScore CLI 封装
│ ├── ops.js compose / render / inspect / transpose / edit / join
│ ├── edit.js 已有乐谱的编辑操作 + 拼接
│ ├── transpose.js MusicXML 移调
│ └── reference.js 语法速查表
├── examples/ 示例乐谱
├── styles/ 示例 .mss 样式
├── docs/ 文档配图
└── test/run.js 37 项单元测试node test/run.js # 37 项单元测试，不需要 MuseScore
node bin/msc.js doctor # 需要 MuseScore 的集成自检
node bin/msc.js compose examples/moonlight-full.msc --formats pdf,png单元测试覆盖：分数运算、时值类型、DSL 解析（和弦/三连音/连音线/歌词/倚音/变拍变调）、小节校验、MusicXML 生成、调号临时记号、移调、以及编辑层的每个操作。
MIT © 2026 Ranger013
本项目只做「排版与转换」，不附带任何曲谱内容。使用生成的乐谱时请自行确认版权。
This server cannot be deployed
ScoreStarling is an all-in-one AI sheet music assistant. Ask for anything to do with sheet music: transcribe a song from audio, video or a link, read a PDF or photo, add chords, change the key, make it easier, turn it into guitar TAB or jianpu, or arrange it for another instrument. Every change lands on a real score you can hear, fix and download (PDF, MIDI, MusicXML, guitar TAB, jianpu, audio). Hosted remote server with OAuth sign-in. Free accounts get monthly credits and free previews; prices are at scorestarling.com/pricing. Setup: https://scorestarling.com/mcp
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
Generate full songs with vocals, instrumentals and sound effects from text. One server for Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE and ElevenLabs. Your agent can quote the credit cost before generating, start a song, wait for it to finish and return download links. Sign in with OAuth; optional daily credit caps; retries never charge twice.
ScanSing reads printed sheet music. Give Claude a PDF or a photo of a score and it gets back MusicXML, the format MuseScore, Sibelius, Finale and Dorico open. It is the recogniser inside the ScanSing app for choir singers, offered as a connector. Once a score is recognised, Claude can answer questions about it without recognising it again: - what the key, time signature, tempo and length are, and each part's range, clefs and lyrics; - one voice on its own, for example just the alto line of a choir piece; - the score or a part moved to another key, with notes respelled for the new key signature; - a MIDI file, one track per part, to listen to or rehearse with; - a short-lived download link to open the result in a browser or notation app. It handles PDFs up to 40 pages and PNG, JPEG, HEIC, TIFF and WebP images, can recognise selected pages of a long PDF, and can split a songbook into one MusicXML per piece. A file can be given as a web link or a small image; in Claude Code, a file on your computer is sent through a one-time upload link. Recognition spends pages from your ScanSing plan, so it is the only tool that is not read-only. Everything else works on the stored result and is free. The first connection with a new email comes with 20 free pages; paid plans start at $9 a month for 300 pages. Scores and results are deleted about an hour after recognition and are never used for training.
