@mseep/midi-file-mcp v0.1.3

🎵 MIDI文件MCP

📖 简介

这是一个基于Tone.js和@tonejs/midi库的MIDI文件解析和操作工具，通过MCP(Model Context Protocol)服务提供功能。这个工具使您能够轻松读取、分析和修改MIDI文件，无需深入了解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文件

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

示例提示

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

1. 获取MIDI文件信息：

   请显示D:\path\to\your\file.mid文件的信息。

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音符。

可用操作

注意：在Windows系统下使用路径时，请始终使用双反斜杠(\\)或正斜杠(/)以避免错误。

📄 许可证

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

🙏 致谢

感谢以下项目和库，没有它们这个工具将无法实现：

• Tone.js - Web音频框架
• @tonejs/midi - MIDI文件解析和操作库
• MCP (Model Context Protocol) - 使工具集成到AI助手成为可能