What is Midi File Mcp

midi-file-mcp is a powerful tool designed for parsing and manipulating MIDI files using Tone.js. It simplifies the complexities of the MIDI file format by leveraging the Model Context Protocol (MCP), allowing AI assistants to easily read, analyze, and modify MIDI files.

Use cases

Use cases for midi-file-mcp include automating music composition, creating MIDI file editors, analyzing MIDI data for educational purposes, and integrating MIDI functionalities into software applications.

How to use

To use midi-file-mcp, you need to install Node.js and configure it with an MCP client such as Cursor or Cherry Studio. Once set up, you can execute commands to read and manipulate MIDI files by providing the absolute path to the files.

Key features

Key features of midi-file-mcp include reading MIDI file information, modifying track, note, control change, and pitch bend data, setting MIDI file tempo (BPM), adding new notes and tracks, and comprehensive error handling.

Where to use

midi-file-mcp can be used in various fields such as music production, game development, and any application that requires MIDI file manipulation and analysis.

🎵 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

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:

• 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:

🎹 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

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