io.github.asampat3090Published by GitHub account asampat3090v0.2.0Updated Nov 5, 2026
Convert MusicXML, MIDI, ABC, MEI and Humdrum, print sheet music, and verify every note survived.
Converts, checks and transforms music scores (MusicXML, MIDI, ABC, MEI, Humdrum) and renders printable sheet music or audio previews.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.asampat3090%2Fscoreproof/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"scoreproof": {
"type": "http",
"url": "https://scoreproof-fkkuctjokq-uc.a.run.app/mcp"
}
}
}Convert any score. Prove nothing got lost.
Scoreproof converts music files between MusicXML, MIDI, ABC, MEI and Humdrum, makes sheet music you can print and play (PDF, PNG), repairs the quirks of real notation-app exports (Sibelius, Dorico, Finale, MuseScore, Guitar Pro and others), and checks every conversion note by note, reporting exactly what was kept and what was lost.
MIDI you played into a DAW or from a keyboard comes out as readable notation: Scoreproof finds the beat (even without a click), snaps rhythms to 16ths or triplets, tidies note lengths, splits piano into two hands and spells notes in the right key.
Use it from any AI tool that speaks MCP (Claude, Cursor, VS Code, Gemini CLI, Codex and others), from the command line, or from Python.
No install. Add a custom connector with this address:
Then ask "Write a short waltz and give me the sheet music". To work on your own file, drop it on the Scoreproof page and paste the link it gives you into the chat; the same page converts files with one click.
The hosted service is free, has per-address rate limits and a 10 MB file limit, and deletes every file after 24 hours.
Scoreproof runs locally and works on files on your computer. It needs uv (brew install uv or pip install uv).
Claude Code
or add the server directly: claude mcp add scoreproof -- uvx scoreproof mcp
Claude Desktop, Cursor, Gemini CLI: add this to claude_desktop_config.json, ~/.cursor/mcp.json or ~/.gemini/settings.json:
VS Code (.vscode/mcp.json):
Codex (~/.codex/config.toml):
Then ask things like:
Results are written next to the input under a new name. Scoreproof never overwrites an existing file unless you give that exact output path.
Add --json to any command for machine-readable output.
On 430 real exports from 11 notation apps (benchmarks/score_corpus/):
MIDI played in a DAW (benchmarks/played_midi/, five pieces performed with human timing):
Every conversion re-reads its own output and compares it with the source. When a format cannot hold something (MIDI has no chord symbols or lyrics layout; ABC and MEI exports carry transposing instruments at concert pitch), the report says so instead of failing silently.
Not supported: native Sibelius, Dorico, Finale and MuseScore files. Export MusicXML from the app first.
The plan and milestones are in docs/plan.md. MIT licensed.
Source: README.md at commit 6d985d0
Convert a music file
Convert a score between formats and verify the result note by note, or turn it into sheet music (pdf, png, svg) or audio (wav). Returns a download link, a confidence level (exact, high, medium, low), the share of notes kept, features the target format cannot hold, and exporter quirks that were repaired on the way in.
torequiredfilecontentfilenameRender sheet music or audio
Engrave sheet music to print or view (PDF, PNG, SVG) or make an audio preview (WAV). Returns download links.
tofilecontentfilenamepage_sizeLook at a score
Summarise a score and show some bars as ABC notation: title, parts with instruments and ranges, key, meters, tempos and bar count.
barsfilepartscontentfilenameCheck a score for problems
Check a score: exporter quirks that needed repair, bars that do not fill their time signature, and notes outside an instrument's range.
filecontentfilenameCompare two versions
Show what changed between two versions of a piece, bar by bar, even across formats.
arequiredbrequiredTranspose a score
Transpose a score by an interval, into a key, or between concert and written pitch. Give exactly one of interval, key or pitch.
tokeyfilepitchcontentfilenameintervalExtract parts or bars
Save chosen parts and/or bars of a score as new files.
tobarsfilepartscontentfilenameeach_partList supported formats
Formats Scoreproof reads and writes, and what each one cannot hold.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
https://scoreproof-fkkuctjokq-uc.a.run.app/mcp/plugin install scoreproof --marketplace asampat3090/scoreproof{ "mcpServers": { "scoreproof": { "command": "uvx", "args": ["scoreproof", "mcp"] } }}{ "servers": { "scoreproof": { "type": "stdio", "command": "uvx", "args": ["scoreproof", "mcp"] } }}[mcp_servers.scoreproof]command = "uvx"args = ["scoreproof", "mcp"]uvx scoreproof convert song.musicxml song.miduvx scoreproof convert take-3.mid --to pdf # played MIDI to sheet musicuvx scoreproof inspect song.musicxml --bars 1-8uvx scoreproof transpose song.musicxml --key "Bb major"uvx scoreproof extract score.mxl --each-partuvx scoreproof render song.musicxml --to png --page-size a4uvx scoreproof --helpfrom scoreproof import convert
result = convert("song.musicxml", "song.mid")result.confidence # "exact", "high", "medium" or "low"result.expected_losses # what MIDI cannot hold: lyrics, chord symbols, ...result.fixes # exporter quirks repaired on the way inpip install -e ".[dev]"pytest --cov=scoreproof # coverage is kept at 100%black src tests benchmarksflake8 src tests benchmarks