Skip to content

Notation Display

The show_notation tool renders MEI files as sheet music using Verovio, a lightweight music notation engraving library. The rendered notation is displayed inline via the MCP Apps extension.

Prerequisites

This tool requires an MCP client that supports the MCP Apps extension (e.g., Claude Desktop with the extension enabled). Without the extension, the tool still returns a text description of the page being shown.

Usage

Full piece

Try asking:

"Show me the notation for Bach_BWV_0772.mei"

Displays the first page of the piece with prev/next pagination controls.

Specific measures

Try asking:

"Show me measures 19 to 22 of Bach_BWV_0772.mei"

Filters the MEI to only include the requested measures before rendering.

Page navigation

The notation viewer displays one system per page. For multi-page pieces, use the interactive prev/next buttons in the viewer, or request a specific page:

Try asking:

"Show page 3 of Bach_BWV_0772.mei"

Parameters

Parameter Type Required Default Description
filename string Yes - Name of the MEI file (e.g., "Bach_BWV_0772.mei")
start_measure integer No None First measure to display
end_measure integer No start_measure Last measure to display
page integer No 1 Page number to display

Return Value

The tool returns a ToolResult with:

  • Text content: A description of what is being shown (e.g., "Showing Bach_BWV_0772.mei, page 1 of 7")
  • Structured content: SVG data and pagination metadata for the viewer app
{
    "filename": "Bach_BWV_0772.mei",
    "svg": "<svg ...>...</svg>",
    "page": 1,
    "total_pages": 7,
    # If measure range was requested:
    "start_measure": 19,
    "end_measure": 22
}

How It Works

  1. The MEI file is read from the built-in collection
  2. If start_measure/end_measure are specified, the MEI XML is filtered to include only those measures
  3. Verovio renders the MEI to SVG server-side (one system per page, ~50-60KB per page)
  4. The SVG is sent to the notation viewer app, which displays it in a sandboxed iframe
  5. Pagination buttons in the viewer call show_notation again with a different page parameter

Technical Details

  • Rendering engine: Verovio 5.5+ (Python bindings, server-side)
  • Output format: SVG, one system per page
  • Page size: Each SVG page is approximately 50-60KB to stay within MCP transport limits
  • Viewer: Custom HTML app using the @modelcontextprotocol/ext-apps SDK