MCP MIDI Server

MCP MIDI 服务

一个 FastMCP 服务，允许大模型向任何支持 MIDI 输入的软件发送 MIDI 序列。

功能

• 创建虚拟 MIDI 输出端口
• 发送 MIDI Note On/Off 消息
• 发送 Control Change（CC）消息
• 以精确的时序排列 MIDI 事件
• 可在任何支持 MIDI 输入的应用程序中用作 MIDI 输入设备

要求

• Python 3.7+
• rtmidi
• fastmcp
• python-dotenv
• asyncio

安装

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
   

用法

运行服务：

python mcp_midi_server.py

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

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

只需在你偏好的 MIDI 兼容应用程序中选择 "MCP MIDI Out" 作为 MIDI 输入设备即可。

MCP 配置

该服务使用 Server-Sent Events（SSE），以下是在 Cursor 中配置的方法：

{
  "mcpServers": {
      "midi": {
          "url": "http://localhost:8123/sse"
      }
   }
}

API 方法

发送 Note On

发送 MIDI Note On 消息。

参数：

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

发送 Note Off

发送 MIDI Note Off 消息。

参数：

• note：MIDI 音符编号（0-127）
• velocity：Note Off 力度（0-127，默认值为 64）
• channel：MIDI 通道（0-15，默认值为 0）

发送 Control Change

发送 MIDI Control Change（CC）消息。

参数：

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

发送 MIDI 序列

发送具有指定时长的一系列 MIDI Note On/Off 消息。

参数：

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

示例

使用 API 播放 C 大调和弦：

events = [
    {"note": 60, "velocity": 100, "duration": 1.0, "start_time": 0.0},  # C4
    {"note": 64, "velocity": 100, "duration": 1.0, "start_time": 0.0},  # E4
    {"note": 67, "velocity": 100, "duration": 1.0, "start_time": 0.0},  # G4
]
# Send to the MCP MIDI Server API

许可证

MIT