🎵 MIDI 文件 MCP

<div align="center">

</div>

<div align="center"> <strong>一个强大的基于 Tone.js 的 MIDI 文件解析和操作 MCP 工具</strong> </div>

<br>

<div align="center"> <img src="https://via.placeholder.com/500x150?text=MIDI+Parser+MCP" alt="MIDI Parser MCP Logo" width="500"> </div>

---

📖 简介

这是一个基于 Tone.js 和 @tonejs/midi 库的 MIDI 文件解析和操作工具，通过 MCP (模型上下文协议) 服务提供功能。 此工具使您可以轻松地读取、分析和修改 MIDI 文件，而无需深入研究 MIDI 文件格式的复杂性。

✨ 特性

• 读取 MIDI 文件信息
• 获取和修改音轨、音符、控制变化和弯音信息
• 设置 MIDI 文件速度 (BPM)
• 向特定音轨添加新的音符、控制变化和弯音
• 添加新的音轨
• 完善的错误处理

📥 前提条件

1. 安装 Node.js: 确保 npx 命令可以正常运行。 建议从 Node.js 官方网站 安装最新的稳定版本。

🔧 用法

与 MCP 客户端一起使用，支持的客户端包括但不限于：

• Cursor
• Cherry Studio
• Claude Desktop

Cursor 配置示例

在 Cursor 中配置 midi-file-mcp：

"midi-file-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "midi-file-mcp"
    ]
}

🎹 使用带有绝对路径的 MIDI Parser MCP

MIDI Parser MCP 中的所有操作都需要 MIDI 文件的绝对路径。 这确保了无论当前工作目录如何，该工具都可以正确地定位和操作您的 MIDI 文件。

示例提示

以下是一些您可以与 AI 助手一起使用的示例提示：

1. 获取 MIDI 文件信息:

   你能展示一下 D:\path\to\your\file.mid 的 MIDI 文件信息吗？
   

2. 分析音轨:

   请分析 D:\path\to\your\file.mid 中的所有音轨，并告诉我每个音轨中有多少个音符。
   

3. 设置速度:

   将 D:\path\to\your\file.mid 的速度更改为 120 BPM。
   

4. 处理音符:

   显示 D:\path\to\your\file.mid 的音轨 1 中的所有音符。
   

5. 添加音符:

   在 D:\path\to\your\file.mid 的音轨 0 中，在位置 0 添加一个持续时间为 1 拍的 C4 音符。
   

可用操作

操作	描述	参数
get_midi_info	获取常规 MIDI 文件信息	filePath
set_tempo	设置 MIDI 文件的速度 (BPM)	filePath, bpm
get_tracks_info	获取有关所有音轨的信息	filePath
get_track_info_by_index	获取有关特定音轨的信息	filePath, trackIndex
get_notes_by_index	从特定音轨获取所有音符	filePath, trackIndex
get_pitchbends_by_index	从特定音轨获取所有弯音	filePath, trackIndex
get_controlchanges_by_index	从特定音轨获取所有控制变化	filePath, trackIndex
add_notes_by_index	将音符添加到特定音轨	filePath, trackIndex, notes
add_controlchanges_by_index	将控制变化添加到特定音轨	filePath, trackIndex, controlchanges
add_pitchbends_by_index	将弯音添加到特定音轨	filePath, trackIndex, pitchbends
add_track	向 MIDI 文件添加新音轨	filePath

注意: 在处理 Windows 路径时，始终在文件路径中使用双反斜杠 (\\) 或正斜杠 (/)，以避免错误。

📄 许可证

该项目已获得 MIT 许可证的许可。 有关详细信息，请参见 LICENSE 文件。

🙏 鸣谢

感谢以下项目和库，没有它们，这个工具是不可能实现的：

• Tone.js - Web Audio Framework
• @tonejs/midi - MIDI 文件解析和操作库
• MCP (模型上下文协议) - 使工具集成到 AI 助手中成为可能