MIDI File MCP
This server provides a powerful MCP tool for parsing, analyzing, and manipulating MIDI files through detailed operations:
Get general information about a MIDI file
Set the tempo (BPM) of a MIDI file
Get information about all tracks or a specific track
Retrieve notes, pitch bends, and control changes from a specific track
Add notes, pitch bends, and control changes to a specific track
Add a new track to the MIDI file
Enables parsing and manipulation of MIDI files, including reading file information, modifying tracks, notes, control changes, and pitch bends, setting tempo, and adding new elements to MIDI files.
Provides the runtime environment for the MCP server, allowing it to execute MIDI file operations through the Tone.js library and its MIDI parsing capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MIDI File MCP set the tempo of C:\Music\song.mid to 128 BPM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎵 MIDI File 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
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:
Claude Desktop
Installing via Smithery
To install MIDI File Parser for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @xiaolaa2/midi-file-mcp --client claudeCursor 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:
Get MIDI File Information:
Can you show me information about the MIDI file at D:\path\to\your\file.mid?Analyzing Tracks:
Please analyze all tracks in D:\path\to\your\file.mid and tell me how many notes are in each track.Setting Tempo:
Change the tempo of D:\path\to\your\file.mid to 120 BPM.Working with Notes:
Show me all notes in track 1 of D:\path\to\your\file.mid.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:
Tone.js - Web Audio Framework
@tonejs/midi - MIDI file parsing and manipulation library
MCP (Model Context Protocol) - Makes tool integration into AI assistants possible
Available Tools
11 toolsadd_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
Scored across 11 tools
Each tool targets a distinct resource (notes, controlchanges, pitchbends, tracks, tempo, info) with clear operations (get, add, set), making them easily distinguishable.
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.
11 tools is well-scoped for MIDI file manipulation, covering essential read and write operations without being excessive or thin.
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
Related MCP Connectors
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
ScoreStarling is an all-in-one AI sheet music assistant. Ask for anything to do with sheet music: transcribe a song from audio, video or a link, read a PDF or photo, add chords, change the key, make it easier, turn it into guitar TAB or jianpu, or arrange it for another instrument. Every change lands on a real score you can hear, fix and download (PDF, MIDI, MusicXML, guitar TAB, jianpu, audio). Hosted remote server with OAuth sign-in. Free accounts get monthly credits and free previews; prices are at scorestarling.com/pricing. Setup: https://scorestarling.com/mcp
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.5MIT
- AlicenseNot gradedqualityDmaintenanceExposes 16 music21 MIDI analysis and editing tools to AI agents, enabling them to read, edit, generate, and analyze MIDI files through natural language.MIT
- AlicenseAqualityDmaintenanceA 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.7MIT
- FlicenseNot gradedqualityDmaintenanceAn 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-