MIDI File MCP

🎵 MIDI 文件 MCP

📖 简介

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

✨ 特点

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

📥 先决条件

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

🔧 使用方法

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

• 光标
• 樱桃工作室
• 克劳德桌面

游标配置示例

在 Cursor 中配置 midi-file-mcp：

🎹 使用 MIDI 解析器 MCP 和绝对路径

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

示例提示

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

1. 获取 MIDI 文件信息：
   Can you show me information about the MIDI file at D:\path\to\your\file.mid?
2. 分析曲目：
   Please analyze all tracks in D:\path\to\your\file.mid and tell me how many notes are in each track.
3. 设置节奏：
   Change the tempo of D:\path\to\your\file.mid to 120 BPM.
4. 使用注释：
   Show me all notes in track 1 of D:\path\to\your\file.mid.
5. 添加注释：
   Add a C4 note at position 0 with a duration of 1 beat to track 0 in D:\path\to\your\file.mid.

可用操作

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

📄 许可证

本项目遵循 MIT 许可证。详情请参阅 LICENSE 文件。

🙏 致谢

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

• Tone.js - Web 音频框架
• @tonejs/midi - MIDI 文件解析和操作库
• MCP（模型上下文协议） ——使工具集成到人工智能助手中成为可能