MIDI Files
Parse and manipulate MIDI files, including reading track information, notes, pitch bends, and control changes. Add new musical elements and modify tempo.
Parse and manipulate MIDI files based on Tone.js
What it does
- Extract track and note information from MIDI files
- Modify MIDI tempo and BPM settings
- Add notes to specific MIDI tracks
- Extract and add pitch bends and control changes
- Analyze MIDI file structure and metadata
Best for
About MIDI Files
MIDI Files is a community-built MCP server published by xiaolaa2 that provides AI assistants with tools and capabilities via the Model Context Protocol. Easily parse and manipulate MIDI files using Tone.js. Streamline your MIDI files workflow with our robust MIDI files sol It is categorized under file systems, other. This server exposes 11 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install MIDI Files in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
MIDI Files is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (11)
Get midi file info
Set tempo for midi file
Get tracks info from midi file
Get track info from midi file by track index. name, instrument, channel, endOfTrackTicks, duration, durationTicks, noteCount
Get notes from midi file by track index
🎵 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.
✨ 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:
- Cursor
- Cherry Studio
- 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 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:
-
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
Alternatives
Related Skills
Browse all skillsPython library for working with DICOM (Digital Imaging and Communications in Medicine) files. Use this skill when reading, writing, or modifying medical imaging data in DICOM format, extracting pixel data from medical images (CT, MRI, X-ray, ultrasound), anonymizing DICOM files, working with DICOM metadata and tags, converting DICOM images to other formats, handling compressed DICOM data, or processing medical imaging datasets. Applies to tasks involving medical image analysis, PACS systems, radiology workflows, and healthcare imaging applications.
Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.
This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks
Tools, patterns, and utilities for creating music with code. Output as a .mp3 file with realistic instrument sounds. Write custom compositions to bring creativity to life through music. This skill should be used whenever the user asks for music to be created. Never use this skill for replicating songs, beats, riffs, or other sensitive works. The skill is not suitable for vocal/lyrical music, audio mixing/mastering (reverb, EQ, compression), real-time MIDI playback, or professional studio recording quality.