-
securityF
license-
qualityThis 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
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.
🎵 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:
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:
- Get MIDI File Information:
- Analyzing Tracks:
- Setting Tempo:
- Working with Notes:
- Adding Notes:
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
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
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.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis 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 -1JavaScriptMIT License
- AsecurityAlicenseAqualityMCP to analyse local audio file.Last updated -810PythonMIT License
- AsecurityAlicenseAqualityMCP server for Synthesizer V AI Vocal Studio, which allows LLMs to create/edit vocal tracks e.g. adding lyrics to the melody.Last updated -6Apache 2.0