MCP MIDI Server

MCP MIDI 服务器

FastMCP 服务器允许 LLM 将 MIDI 序列发送到任何支持 MIDI 输入的软件。

特征

• 创建虚拟 MIDI 输出端口
• 发送 MIDI 音符开/关消息
• 发送控制变更 (CC) 消息
• 以精确的时间对 MIDI 事件进行排序
• 可在任何支持 MIDI 的应用程序中用作 MIDI 输入设备

要求

• Python 3.7+
• rtmidi
• fastmcp
• python-dotenv
• 异步

安装

1. 克隆存储库：
   git clone <repository-url> cd mcp-server-midi
2. 创建虚拟环境，激活它并安装依赖项：
   python -m venv .venv source .venv/bin/activate pip install -r requirements.txt
3. 使用您的配置创建一个.env文件：
   PORT=8123

用法

运行服务器：

服务器会创建一个名为“MCP MIDI Out”的虚拟 MIDI 端口，可在其他应用程序中用作 MIDI 输入设备。这意味着您可以：

• 连接数字音频工作站 (DAW)，如 Ableton Live、Logic Pro 或 FL Studio，以从此服务器接收 MIDI
• 使用服务器通过计算机的 MIDI 接口控制硬件合成器
• 连接到任何其他接受 MIDI 输入的软件（虚拟乐器、照明控制器等）

只需在您首选的 MIDI 兼容应用程序中选择“MCP MIDI Out”作为 MIDI 输入设备。

MCP 配置

服务器使用服务器发送事件（SSE），这是在 Cursor 中配置它的方法：

API 方法

发送注释

发送 MIDI Note On 消息。

参数：

• note ：MIDI 音符编号（0-127）
• velocity ：音符速度（0-127，默认127）
• channel ：MIDI 通道（0-15，默认 0）

发送注释关闭

发送 MIDI 音符关闭消息。

参数：

• note ：MIDI 音符编号（0-127）
• velocity ：音符关闭速度（0-127，默认64）
• channel ：MIDI 通道（0-15，默认 0）

发送控制变更

发送 MIDI 控制变化 (CC) 消息。

参数：

• controller ：CC控制器编号（0-127）
• value ：CC值（0-127）
• channel ：MIDI 通道（0-15，默认 0）

发送 MIDI 序列

发送具有指定持续时间的一系列 MIDI 音符开/关消息。

参数：

• events ：事件字典列表。每个字典必须包含：
  • note ：MIDI 音符编号（0-127）
  • velocity ：音符速度（0-127，默认127）
  • channel ：MIDI 通道（0-15，默认 0）
  • duration ：发送 Note Off 之前保持音符的时间（秒）
  • start_time ：相对于序列开始的时间（以秒为单位）（默认值为 0）

例子

使用 API 弹奏 C 大调和弦：

执照

麻省理工学院