Data · MODEL CONTEXT PROTOCOL
xiaolaa2 midi file mcp
A powerful MCP tool for parsing and manipulating MIDI files based on Tone.js. This library leverages the Model Context Protocol (MCP) to enable AI assistants to easily read, analyze, and modify MIDI files without dealing with the complexities of the MIDI file format.
连接能力
xiaolaa2 midi file mcp 为 AI Agent 提供什么
来源目录未提供结构化功能列表，请在使用前阅读源仓库文档。
安全
MCP 收录不等于安全审核
MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前，请检查代码、环境变量、网络行为、软件包来源与维护状态。
README
仓库文档
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.
- 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
- 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
Use with an MCP client, supported clients include but are not limited to:
- Cursor
- Cherry Studio
- Claude Desktop
To install MIDI File Parser for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @xiaolaa2/midi-file-mcp --client claudeConfigure midi-file-mcp in Cursor:
"midi-file-mcp": {
"command": "npx",
"args": [
"-y",
"midi-file-mcp"
]
}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.
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.
| 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.
This project is licensed under the MIT License. See the LICENSE file for details.
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
社区