MIDI File MCP

Integrations

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

🎵 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 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
OperationDescriptionParameters
get_midi_infoGet general MIDI file informationfilePath
set_tempoSet the tempo (BPM) of a MIDI filefilePath, bpm
get_tracks_infoGet information about all tracksfilePath
get_track_info_by_indexGet information about a specific trackfilePath, trackIndex
get_notes_by_indexGet all notes from a specific trackfilePath, trackIndex
get_pitchbends_by_indexGet all pitch bends from a specific trackfilePath, trackIndex
get_controlchanges_by_indexGet all control changes from a specific trackfilePath, trackIndex
add_notes_by_indexAdd notes to a specific trackfilePath, trackIndex, notes
add_controlchanges_by_indexAdd control changes to a specific trackfilePath, trackIndex, controlchanges
add_pitchbends_by_indexAdd pitch bends to a specific trackfilePath, trackIndex, pitchbends
add_trackAdd a new track to the MIDI filefilePath

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:

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A powerful MCP tool for parsing and manipulating MIDI files that allows users to read, analyze, and modify MIDI files through natural language commands, supporting operations like reading file information, modifying tracks, adding notes, and setting tempo.

  1. 📖 Introduction
    1. ✨ Features
      1. 📥 Prerequisites
        1. 🔧 Usage
          1. Cursor Configuration Example
          2. 🎹 Using MIDI Parser MCP with Absolute Paths
        2. 📄 License
          1. 🙏 Acknowledgements

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              This TypeScript-based MCP server allows users to manage a simple notes system through creating and summarizing text notes using Model Context Protocol (MCP).
              Last updated -
              410
              5
              TypeScript
              • Apple
            • A
              security
              A
              license
              A
              quality
              This TypeScript-based MCP server allows users to manage and interact with a note system through Model Context Protocol, enabling note creation and summarization with URIs and metadata.
              Last updated -
              1
              JavaScript
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              An MCP server implementation that integrates with SiYuan Note system, enabling AI models to access and manipulate note data through comprehensive commands for notebook management, document operations, and content manipulation.
              Last updated -
              3
              104
              1
              TypeScript
              ISC License
              • Linux
              • Apple

            View all related MCP servers

            ID: hqzbh86gt8