Skip to main content
Glama

🎵 MIDI File MCP

license tonejs MCP


📖 Introduction

This is a MIDI file parsing and manipulation tool based on Tone.js and the @tonejs/midi library, providing functionality through MCP (Model Context Protocol) services. This tool allows you to easily read, analyze and modify MIDI files without delving into the complexities of the MIDI file format.

Related MCP server: music21-mcp

✨ Features

  • Read MIDI file information

  • Get and modify track, note, control change, and pitch bend information

  • Set MIDI file tempo (BPM)

  • Add new notes, control changes, and pitch bends to specific tracks

  • Add new tracks

  • Comprehensive error handling

📥 Prerequisites

  1. Install Node.js: Ensure that the npx command can run normally. It is recommended to install the latest stable version from the Node.js official website

🔧 Usage

Use with an MCP client, supported clients include but are not limited to:

Installing via Smithery

To install MIDI File Parser for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @xiaolaa2/midi-file-mcp --client claude

Cursor Configuration Example

Configure midi-file-mcp in Cursor:

"midi-file-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "midi-file-mcp"
    ]
}

🎹 Using MIDI Parser MCP with Absolute Paths

All operations in MIDI Parser MCP require the absolute path to the MIDI file. This ensures that the tool can correctly locate and manipulate your MIDI files regardless of the current working directory.

Example Prompts

Here are some example prompts you can use with your AI assistant:

  1. Get MIDI File Information:

    Can you show me information about the MIDI file at D:\path\to\your\file.mid?
  2. Analyzing Tracks:

    Please analyze all tracks in D:\path\to\your\file.mid and tell me how many notes are in each track.
  3. Setting Tempo:

    Change the tempo of D:\path\to\your\file.mid to 120 BPM.
  4. Working with Notes:

    Show me all notes in track 1 of D:\path\to\your\file.mid.
  5. Adding Notes:

    Add a C4 note at position 0 with a duration of 1 beat to track 0 in D:\path\to\your\file.mid.

Available Operations

Operation

Description

Parameters

get_midi_info

Get general MIDI file information

filePath

set_tempo

Set the tempo (BPM) of a MIDI file

filePath, bpm

get_tracks_info

Get information about all tracks

filePath

get_track_info_by_index

Get information about a specific track

filePath, trackIndex

get_notes_by_index

Get all notes from a specific track

filePath, trackIndex

get_pitchbends_by_index

Get all pitch bends from a specific track

filePath, trackIndex

get_controlchanges_by_index

Get all control changes from a specific track

filePath, trackIndex

add_notes_by_index

Add notes to a specific track

filePath, trackIndex, notes

add_controlchanges_by_index

Add control changes to a specific track

filePath, trackIndex, controlchanges

add_pitchbends_by_index

Add pitch bends to a specific track

filePath, trackIndex, pitchbends

add_track

Add a new track to the MIDI file

filePath

Note: Always use double backslashes (\\) or forward slashes (/) in file paths when working with Windows paths to avoid errors.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgements

Thanks to the following projects and libraries, without which this tool would not be possible:

Available Tools

11 tools
add_controlchanges_by_indexC

Add controlchanges to midi file by track index

Inputs: filePath (required), trackIndex (required), controlchanges (required).

add_notes_by_indexB

Add notes to midi file by track index

Inputs: filePath (required), trackIndex (required), notes (required).

add_pitchbends_by_indexC

Add pitchbends to midi file by track index

Inputs: filePath (required), trackIndex (required), pitchbends (required).

add_trackB

Add a new track to midi file and return the new track info

Inputs: filePath (required).

get_controlchanges_by_indexC

Get controlchanges from midi file by track index

Inputs: filePath (required), trackIndex (required).

get_midi_infoC

Get midi file info

Inputs: filePath (required).

get_notes_by_indexB

Get notes from midi file by track index

Inputs: filePath (required), trackIndex (required).

get_pitchbends_by_indexB

Get pitchbends from midi file by track index

Inputs: filePath (required), trackIndex (required).

get_track_info_by_indexB

Get track info from midi file by track index. name, instrument, channel, endOfTrackTicks, duration, durationTicks, noteCount

Inputs: filePath (required), trackIndex (required).

get_tracks_infoC

Get tracks info from midi file

Inputs: filePath (required).

set_tempoC

Set tempo for midi file

Inputs: filePath (required), bpm (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource (notes, controlchanges, pitchbends, tracks, tempo, info) with clear operations (get, add, set), making them easily distinguishable.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case, e.g., add_notes_by_index, get_midi_info, set_tempo. No mixed conventions.

    Tool Count5/5

    11 tools is well-scoped for MIDI file manipulation, covering essential read and write operations without being excessive or thin.

    Completeness3/5

    The tool set covers adding and getting notes, control changes, and pitch bends, but lacks update and delete operations for those events, as well as removing tracks or clearing data.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables comprehensive analysis of MIDI SMF files including loading, parsing, track analysis, event extraction with filtering, and detailed file summaries. Supports memory management for efficient repeated access to loaded MIDI files.
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes 16 music21 MIDI analysis and editing tools to AI agents, enabling them to read, edit, generate, and analyze MIDI files through natural language.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A game-agnostic MCP toolkit for composing chiptune/retro MIDI and rendering game audio, enabling AI agents to generate multi-track MIDI files and render them to OGG/WAV.
      7
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that transcribes audio files into MIDI and MusicXML scores, converts MIDI to notation, and extracts playable note data for DAWs. It enables Claude to turn raw recordings into editable, shareable music scores via three simple tools.
      1
      -