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]。