MCP Server Midi

🚀 MCP MIDI 服务器

MCP MIDI 服务器是一个快速响应的服务器，它为大型语言模型（LLM）提供了将 MIDI 序列发送到任何支持 MIDI 输入软件的能力，极大地拓展了 MIDI 数据的传输和应用场景。

🚀 快速开始

运行服务器前，请确保你已经完成了环境的搭建和配置。运行以下命令启动服务器：

python mcp_midi_server.py

服务器启动后，会创建一个名为“MCP MIDI Out”的虚拟 MIDI 端口，你可以在任何支持 MIDI 的应用程序中选择此端口作为 MIDI 输入设备，从而实现 MIDI 数据的传输。

✨ 主要特性

• 虚拟端口创建：能够创建一个虚拟的 MIDI 输出端口，方便与各类软件进行对接。
• 消息发送功能：支持发送 MIDI 音符开/关消息以及控制变化（CC）消息，满足多样化的 MIDI 控制需求。
• 精确时间安排：可以按照精确的时间安排 MIDI 事件，实现精准的音乐创作和控制。
• 广泛设备兼容：可作为任何支持 MIDI 的应用程序中的 MIDI 输入设备使用，适配性强。

📦 安装指南

克隆仓库

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

创建并激活虚拟环境，安装依赖项

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

创建并配置 .env 文件

PORT=8123

💻 使用示例

基础用法

以下是一个使用 API 发送 MIDI 序列的基础示例：

import mcp_midi_server as mcp

# 创建一个MIDI服务器实例
server = mcp.MIDIServer()

# 定义一个回调函数来处理MIDI输入
def on_midi_input(event):
    print(f"收到MIDI事件：{event}")

# 启动MIDI服务器并注册回调函数
server.start(port=8123, on_input=on_midi_input)

# 发送一个音符开消息
server.send_note_on(note=60, velocity=100, channel=0)

# 等待一段时间（以秒为单位）
import time
time.sleep(1)

# 发送一个音符关消息
server.send_note_off(note=60, velocity=64, channel=0)

# 停止MIDI服务器
server.stop()

📚 详细文档

MCP 配置

该服务器使用服务器发送事件（SSE），以下是配置示例：

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

🔧 技术细节

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）
  • time：事件发生的时间（以毫秒为单位）

📄 许可证

该库的许可遵循[MIT License]。