MCP MIDI 服务器

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

特性

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

要求

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

安装

1. 克隆仓库：

   git clone <repository-url>
   cd mcp-server-midi
   

2. 安装依赖：

   pip install rtmidi fastmcp python-dotenv
   

3. 创建一个 .env 文件，包含你的配置：

   PORT=8000
   

使用

运行服务器：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python mcp_midi_server.py

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

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

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

API 方法

发送音符开

发送 MIDI 音符开消息。

参数：

• 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: 在发送音符关之前保持音符的时间（以秒为单位）
  • 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
]
# 发送到 MCP MIDI 服务器 API

许可证

MIT