Sheet Music OMR MCP server

sheet-music-mcp

Six MCP servers that let an AI assistant work with sheet music: read a photo of a score, render it, play single voice parts, edit it as text, compare editions and follow a singer in real time. Built for choir rehearsal.

"Here is a photo of page 1. Convert it to MusicXML and play me the alto part at 80% tempo."

The assistant calls omr-mcp to recognise the page, then synth-mcp to render the alto line to a WAV file.

Servers

Each server is a separate PyPI package, listed in the MCP Registry as io.github.raulkivi/.

All servers use stdio and need Python 3.11+ (3.12+ for pitch-mcp) and uv.

Quick start

Add the servers you need to your MCP client configuration (claudedesktopconfig.json, Cursor's mcp.json and similar):

{
  "mcpServers": {
    "omr": { "command": "uvx", "args": ["omr-mcp"] },
    "render": { "command": "uvx", "args": ["render-mcp"] },
    "synth": {
      "command": "uvx",
      "args": ["synth-mcp"],
      "env": { "SYNTH_SOUNDFONT_PATH": "/path/to/soundfont.sf2" }
    }
  }
}

Claude Code:

claude mcp add omr -- uvx omr-mcp

Each server's SETUP.md walks through installation for non-developers, and examples/ has ready-made configs for Claude Desktop, Cursor, Windsurf, Continue and Zed. Every server has a health_check tool that reports missing system libraries or files.

Security

• PyPI releases use Trusted Publishing from GitHub Actions and carry PEP 740 attestations; no API tokens are stored.
• Workflow actions are pinned to commit SHAs; Dependabot keeps them and the Python dependencies current.
• Pull requests run CodeQL, a Claude security review and unicode-smuggling-guard, which blocks hidden Unicode in code, docs and agent files.
• Secret scanning and push protection are on.
• Report vulnerabilities privately: see SECURITY.md.

Background

The project started as a choir assistant: help singers digitize, practice with, and navigate sheet music on their phones.

Goals

Shortened. The full README is on GitHub.