FL Studio MCP Mac

FL Studio MCP Mac

macOS を第一に考えた、FL Studio 用の MCP ブリッジです。FL Studio のトランスポート、ミキサー、チャンネル、MIDI エクスポート、ピアノロールのノート適用ワークフローを、Claude Desktop、Claude Code、Cursor などの MCP クライアントや、その他の MCP 対応ツールに公開します。

これはアルファ版の MVP です。対象範囲は、FL Studio の公式に文書化された Python MIDI スクリプト API とピアノロールのスクリプト API を中心に意図的に限定しています。FL Studio の完全なヘッドレス自動化を保証するものではありません。

このプロジェクトの目的

現在の FL Studio 向け MCP の取り組みの多くは、Windows を対象としています。macOS では、仮想ポートに対してよりシンプルな CoreMIDI 経路が利用でき、FL Studio は macOS 上で Python ベースの MIDI スクリプトをサポートしています。このプロジェクトは、それらを小規模なローカル MCP サーバーと付属の FL Studio スクリプトにまとめています。

動作する機能

• macOS の仮想 MIDI ポートを介したライブブリッジ。
• FL Studio の状態確認とヘルスチェック。
• トランスポート：再生、停止、録音の切り替え、巻き戻し、ソング／パターンモード、メトロノームの切り替え。
• テンポの変更。
• ミキサートラックの読み取りと、明示的なトラックの変更。
• チャンネルラックの読み取りと、明示的なチャンネルの変更。
• FL Studio へのインポート用の標準 MIDI ファイルの生成。
• ノートを保持して挿入する、ピアノロールのキューファイルと付属の .pyscript。

既知の制限事項

• FL Studio の MIDI スクリプト API は、完全な DAW API ではありません。
• プラグインの読み込み、任意のオーディオファイルの読み込み、レンダリング／エクスポートには対応していません。
• ノートの保持には、付属のピアノロールスクリプトを使用します。MCP サーバーがノートをキューに追加した後、対象のピアノロールで Scripts > FL Studio MCP Apply を実行してください。
• ライブブリッジの設定では、リクエスト／レスポンスポートを割り当てるために FL Studio の MIDI 設定が必要です。MCP サーバーは単一インスタンスのローカル MIDI デーモンを起動するため、Claude Desktop、Claude Code、ターミナルでのテストが同じ CoreMIDI エンドポイントを共有できます。

インストール

このリポジトリから実行します：

python3 -m pip install .
flstudio-mcp-mac-install

インストーラーは次のファイルをコピーします：

• device_FLStudioMCP.py を ~/Documents/Image-Line/FL Studio/Settings/Hardware/FLStudioMCP/ に
• FL Studio MCP Apply.pyscript を ~/Documents/Image-Line/FL Studio/Settings/Piano roll scripts/ に

macOS での FL Studio の設定

1. MCP サーバーを一度起動し、ローカル MIDI デーモンを起動して仮想 CoreMIDI ポートを作成します：

   flstudio-mcp-mac
   

   ポートが表示されたら、このフォアグラウンドの MCP プロセスは停止してかまいません。バックグラウンドデーモンにより、すべての MCP クライアントで FLStudioMCP Request ポートと FLStudioMCP Response ポートを利用できます。

2. FL Studio を開き、Options > MIDI Settings に移動します。

3. 入力リストから FLStudioMCP Request を選択します。

4. Controller type を FL Studio MCP Mac に設定します。

5. コントローラーの出力を FLStudioMCP Response に設定します。

6. 必要に応じて MCP クライアントを再起動します。FLStudioMCP ポートが重複して表示される場合は、古い MCP サーバープロセスを終了し、v0.1.1 以降のデーモンを再度起動してください。

MCP クライアントの設定

Claude Desktop、Claude Code、Cursor、Windsurf、PyPI、MCP Registry での詳細な設定については、docs/publishing.md を参照してください。

Claude Desktop の設定例：

{
  "mcpServers": {
    "flstudio-mcp-mac": {
      "command": "flstudio-mcp-mac"
    }
  }
}

コマンドが PATH にないソースインストールの場合：

{
  "mcpServers": {
    "flstudio-mcp-mac": {
      "command": "python3",
      "args": ["-m", "flstudio_mcp_mac"]
    }
  }
}

MIDI ノートのワークフロー

通常の .mid ファイルをインポートする場合は、fl_create_midi_file を使用します。

現在開いているピアノロールにノートを適用する場合は、fl_queue_piano_roll_notes を使用します：

1. MCP クライアントにノートをキューに追加するよう依頼します。
2. FL Studio で、対象チャンネルのピアノロールを開きます。
3. Scripts > FL Studio MCP Apply を実行します。

ノートの形式：

[
  { "pitch": 60, "start": 0, "duration": 1, "velocity": 100 },
  { "pitch": 64, "start": 1, "duration": 1, "velocity": 96 },
  { "pitch": 67, "start": 2, "duration": 2, "velocity": 96 }
]

時間の単位は拍です。MIDI のピッチには、標準の 0～127 のスケールを使用します。

開発

python3 -m pip install ".[dev]"
PYTHONPATH=src pytest

プロトコルテスト用に、決定論的なインメモリ FL Studio 応答を使って MCP サーバーを実行するには、FLSTUDIO_MCP_BRIDGE=mock を設定します：

FLSTUDIO_MCP_BRIDGE=mock python3 -m flstudio_mcp_mac

通常のライブモードでは、バックグラウンドデーモンを使用します。低レベルのデバッグでは、FLSTUDIO_MCP_BRIDGE=direct を設定すると、1 つの MCP プロセスが仮想 MIDI ポートを直接所有します。

FL Studio でのライブ検証手順については、docs/testing.md を参照してください。

プロトコル

ブリッジは、チャンネル 16 の MIDI コントロールチェンジフレームを介して、Base64 エンコードされた JSON を送信します。

• CC 120：フレーム開始
• CC 121：Base64 文字を 1 文字送信
• CC 122：フレーム終了

FL スクリプトは、許可リストに登録されたコマンド名のみを受け付け、リクエストごとに 1 つの JSON レスポンスを返します。

プライバシー

このサーバーはすべてお使いのマシン上で動作します。テレメトリーは収集せず、リモートサービス上にデータを保存することもありません。macOS の仮想 MIDI ポート（CoreMIDI）を介して、ローカルの FL Studio インスタンスとのみ通信します。また、ファイルを書き込むのは、指定された場所（ローカルの Music フォルダーにある生成 MIDI ファイルと Piano Roll キューの JSON ファイル）のみです。アカウント、API キー、ネットワーク接続は不要で、FL Studio で行った操作がコンピューターの外部に送信されることはありません。

開発者

Puya Ventures LLC が開発しました。カスタム MCP サーバーと AI 統合を開発しています。 お問い合わせ：[email protected] | ポートフォリオ：https://puyarahmanian.com

ライセンス

MIT。LICENSE をご覧ください。