encoding-music-mcp

MCP server for analyzing MEI (Music Encoding Initiative) files. Provides tools to extract metadata, analyze musical structure, and understand encoded scores.

Features

• 46 Built-in MEI Files: Bach Inventions, Bartók Mikrokosmos, Morley Canzonets - ready to analyze
• MEI Metadata Extraction: Extract title, composer, editors, analysts, publication dates, and copyright information
• Key Analysis: Detect musical keys with confidence scores using music21
• Interval Analysis: Extract notes, melodic intervals, harmonic intervals, and melodic n-grams using CRIM Intervals
• Notation Display: Render sheet music as SVG with interactive pagination using Verovio (requires MCP Apps extension)
• Simple & Efficient: Tools read directly from disk - no token waste

Documentation

📚 Read the full documentation for:

• Detailed tool reference
• Quick start guides
• MEI file collection details
• Development guides
• API reference

Installation

Prerequisites: This project requires uv to be installed.

Option 1: Quick Start (using uvx)

No cloning required! Add this to your MCP client configuration:

{
  "mcpServers": {
    "encoding-music-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/unimelbmdap/encoding-music-mcp.git",
        "encoding-music-mcp"
      ]
    }
  }
}

Option 2: Local Development

Clone the repository and install dependencies:

git clone https://github.com/unimelbmdap/encoding-music-mcp.git
cd encoding-music-mcp
uv sync

Usage

With Claude Desktop

1. Open your Claude Desktop configuration file:

   • In Claude Desktop, open Settings > Developer
   • Under Local MCP servers, click Edit Config

2. Add configuration (choose one method):

Method A: Using uvx (no clone needed)

{
  "mcpServers": {
    "encoding-music-mcp": {
      "command": "uvx",
      "args": [
        "--from",