MCP Server Midi

🚀 MCP MIDI サーバ

このサーバは、大型言語モデル（LLM）がMIDIシーケンスをMIDI入力に対応したソフトウェアに送信できる高速なMCPサーバです。

🚀 クイックスタート

このMCP MIDIサーバを使用することで、大型言語モデル（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. 仮想環境を作成し、アクティブ化して依存関係をインストールします。

   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に対応したアプリケーションのMIDI入力デバイスとして使用できます。具体的には以下のことが可能です。

• Ableton Live、Logic Pro、FL Studioなどのデジタルオーディオワークステーション（DAW）をこのサーバに接続してMIDIを受信できます。
• このサーバを使用して、コンピュータのMIDIインターフェースを介してハードウェアシンセサイザを制御できます。
• MIDI入力を受け付ける他のソフトウェア（バーチャル楽器、ライトコントローラなど）に接続できます。

好みのMIDI対応アプリケーションで「MCP MIDI Out」をMIDI入力デバイスとして選択するだけです。

高度な使用法

以下は、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]に基づいてライセンスされています。