MIDI Files

🚀 🎵 MIDI 文件 MCP 工具

这是一个强大的基于 Tone.js 的 MCP 工具，用于解析和操作 MIDI 文件。借助该工具，你无需深入了解 MIDI 文件格式的复杂性，就能轻松读取、分析和修改 MIDI 文件。

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

📥 前提条件

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

💻 使用示例

与 MCP 客户端配合使用

此工具可与 MCP 客户端配合使用，支持的客户端包括但不限于：

• Cursor
• Cherry Studio
• Claude Desktop

在 Cursor 中配置 MIDI 文件 MCP 工具示例

在 Cursor 中配置 midi-file-mcp：

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

🎹 使用绝对路径的 MIDI 解析器 MCP 工具

MIDI 解析器 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 中，向第一音轨添加一个 MIDI 音符，其通道号为 1，力度为 127。这个音符应该在第 3 小节的开始处播放，并持续到第 4 小节。

参数

以下是各个操作的参数说明：

📚 详细文档

通过这个工具，您可以在 AI 助手的帮助下高效地处理 MIDI 文件，实现音乐制作和音频处理的各种需求。

📄 许可证

🔧 技术支持

如果您有任何问题或需要进一步的帮助，请联系 支持团队。