Postfader

AIアシスタントにFL Studioの「目」と「手」を与える

開いているプロジェクトの調査、慎重に検証された変更、書き出したミックスの比較を、MCP互換のAIクライアントからすべて実行できます。

機能 · 対応AIクライアント · クイックスタート · 対応バージョン · 安全性 · ドキュメント

[!NOTE] Postfaderは非公式のコミュニティプロジェクトです。Image-Line社による製品でも、同社との提携によるものでもありません。

Postfaderは、小さなコントローラスクリプトを通じてローカルのAIクライアントをFL Studioに接続します。現在のプロジェクトについて質問したり、対応しているコントロールを変更したり、ノートを試聴したり、オーディオファイルを測定したりできます。カスタムのFL Studio統合を構築する必要はありません。

37の焦点を絞ったツールが含まれています:

• 開いているFL Studioプロジェクトを読み取る12のツール;

• 対応しているプロジェクト設定を変更し、結果を確認する19のツール;

• FL Studioを再起動せずにそれらの変更を有効または無効にする1つのセッションコントロール;

• 短いライブノート試聴用の1つのツール;

• 書き出したオーディオファイルを分析する4つのツール。

対応AIクライアント

Postfaderはモデルやベンダーに依存しません。標準のローカルstdio MCPトランスポートを使用するため、ローカルプロセスを起動できるMCP互換のデスクトップまたはコーディングクライアントであれば、どれでも動作します。

この互換性は、FL Studioと同じコンピュータ上でPostfaderを起動できるローカルクライアントに適用されます。ブラウザのみのチャットインターフェースは、接続する前に独自のローカルMCPまたはプラグインランタイムが必要です。

Related MCP server: FL Studio MCP Server

できること

Postfaderは、ネイティブのFLエフェクト、VST/VST3/AUエフェクト、Channel Rackジェネレーターが公開するパラメータの検査と制御もできます。プラグインサポートは固定リストに限定されず、FL Studioから実行時に検出されます。

リクエストの例

“Show me every used mixer track and where it routes.”

“Which Channel Rack instruments are not assigned to a mixer insert?”

“Rename insert 4 to Lead Vocal, set its pan to 10% left, and confirm both changes.”

“Set the tempo to 128 BPM while the project is stopped.”

“Enable write mode for this session, then rename insert 4 to Lead Vocal.”

“Compare my latest bounce with the reference and summarize the loudness,
stereo, dynamics, and frequency-band differences.”

Postfaderを使う理由

• クリエイティブな流れを保つ。 複数のFL Studioウィンドウを探し回ることなく、プロジェクト情報や日常的な変更を依頼できます。

• 変更が反映されたかどうかを確認できる。 Postfaderは変更後にサポート対象のコントロールを読み戻し、変更前の状態、変更後の状態、結果を報告します。

• 安全に開始できる。 Postfaderは読み取り専用モードで接続します。準備ができたら、AIクライアントに現在のセッションの書き込みを有効にするよう依頼します。FL Studioの再起動は不要です。

• すでに所有しているプラグインを使用できる。 Postfaderは、プラグインごとにカスタムプロファイルを必要とせず、FL Studioが公開するパラメータサーフェスを検出します。

• ローカルで完結する。 Postfaderにはホスト型サービス、アカウント、テレメトリ、プロジェクトのアップロード手順はありません。

「検証済み」の意味

サポート対象の変更について、Postfaderは:

1. ターゲット、値、現在のセッション、指定された変更前の状態をチェックします;

2. FL Studioに変更を依頼します;

3. 後続のFL Studioアップデートを待って、コントロールを再度読み取ります;

4. 要求された状態が実際に観測されたかどうかを報告します。

これにより、一般的な自動化の失敗を検出できます: FL Studioまたはプラグインがコマンドを受け入れても値を無視するケースです。

[!IMPORTANT] 検証済みの結果は、コントロールが要求された設定で観測されたことを意味します。音楽的な選択が良い音であることを意味するものではありません。書き込みは開いているプロジェクトに即座に影響し、自動的にロールバックされることはありません。Postfaderがプロジェクトを保存することはありません。

仕組み

flowchart LR
    A["Your AI client<br/>(MCP)"] --> B["Postfader<br/>runs locally"]
    B -->|"Virtual MIDI"| C["Universal Bridge<br/>inside FL Studio"]
    C --> D["Your open project"]
    B -->|"Files you choose"| E["Exported audio<br/>measurements"]

MCPは、AIクライアントがPostfaderの名前付きツールを呼び出せるようにする接続です。FL Studioとのライブ通信は、1つのローカル仮想MIDIエンドポイントを介して行われます。オーディオ分析は、FL StudioのスクリプトAPIがライブオーディオバッファを提供しないため、ディスクから書き出したファイルを読み取ります。

対応バージョン

Python 3.13/3.14およびWindows ARM64では、python-rtmidi用にネイティブコンパイラが必要な場合があります。現在のWindows CIはx64で実行されています。

クイックスタート

1. 仮想MIDIエンドポイントを準備する

• macOS: Audio MIDI SetupでIACバスを有効にします。

• Windows: お好みの仮想MIDIソフトウェアで双方向エンドポイントを1つ作成します。

Postfaderは仮想MIDIソフトウェアをインストールまたは設定しません。FL StudioのMIDI入力と出力の両方に同じエンドポイントを使用します。

Postfaderをインストールする前にFL Studioを一度起動してユーザーデータフォルダを作成させ、その後FL Studioを終了します。

2. Postfaderをインストールする

macOS

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
cd postfader-fl-studio-mcp
./scripts/install.sh

Windows PowerShell

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
Set-Location postfader-fl-studio-mcp
.\scripts\install.ps1 -DryRun
.\scripts\install.ps1

インストーラーはローカルの.venvを作成し、Postfaderをインストールし、Universal BridgeをFL Studioのコントローラスクリプトフォルダにコピーします。AIクライアントの設定は変更されません。

公開されているPythonパッケージをインストールすることもできます:

pip install postfader-fl-studio-mcp
postfader-install-bridge

3. FL Studioを接続する

FL Studioでオプション → MIDI設定を開きます:

1. 入力で仮想エンドポイントを有効にします。

2. コントローラタイプをUniversal Bridgeに設定します。

3. 入力にFL Studioポート番号を割り当てます。

4. 出力で同じエンドポイントを有効にし、同じポート番号を割り当てます。

5. 表示 → スクリプト出力を開き、スクリプトを再読み込みします。

スクリプトはready: MIDI SysExを報告するはずです。

4. 接続を確認する

macOS

./.venv/bin/postfader-doctor --midi-port "IAC Driver Bus 1" --json

Windows PowerShell

.\.venv\Scripts\postfader-doctor.exe --midi-port "Exact Virtual MIDI Endpoint Name" --json

正常な接続では以下が報告されます:

• overall: "pass";

• ライブのFL Studio接続;

• インストールされたPostfaderバージョンと一致するコントローラスクリプト;

• bridge_mode: "read_only"; および

• verified_writes_enabled: false; および

• runtime_write_mode_control: true。

5. PostfaderをAIクライアントに追加する

インタープリタのパス、リポジトリのパス、エンドポイント名が明示されるように、同梱の設定ジェネレーターを使用します:

./.venv/bin/python scripts/generate_mcp_config.py --help

.\.venv\Scripts\python.exe scripts\generate_mcp_config.py --help

Codexコマンド、Codex TOML、またはClaude互換クライアント、Cursor、その他多くのMCPクライアントで使用される標準のmcpServers JSONを生成できます。完全なmacOSおよびWindowsの例については、クライアント設定ガイドを参照してください。

Claude Desktopユーザーはリリースの.mcpbを開くことができますが、この拡張機能はFL Studioコントローラスクリプトをインストールしたり、仮想MIDIエンドポイントを作成したりしません。最初に手順1〜4を完了してください。

デフォルトで安全

読み取り専用モード

通常のFL Studio起動では、Postfaderは読み取り専用のままです。プロジェクトの検査は機能しますが、プロジェクトを変更するツールは機能しません。オーディオファイルの分析も、ライブのFL Studio接続なしで機能します。これは実際のセッションを探索するための推奨モードです。

書き込みモード

Postfaderに変更を実行させたい場合は、接続中のAIクライアントに次のように依頼します:

“Enable write mode for this session.”

クライアントはfl_set_write_modeを呼び出し、明示的なユーザーが存在する確認を伴う必要があります。Postfaderは実行中のコントローラスクリプトをチェックし、そのライブセッションのみを変更し、書き込みが利用可能であることを報告する前に2回目のハンドシェイクを実行します。FL Studioを再起動する必要はありません。

終了したら、クライアントに「書き込みモードを無効にする」よう依頼します。この設定はプロジェクトやAIクライアントの設定に保存されることはなく、通常のコントローラスクリプトの再読み込みや新しいFL Studioプロセスは再び読み取り専用で開始されます。初めて書き込みを試すときは、空のプロジェクトまたは使い捨てのプロジェクトを使用してください。

追加の安全対策は次のとおりです:

• 書き込みの有効化には明示的なユーザー要求が必要であり、破壊的な機能変更としてMCPクライアントに公開されます。

• Masterトラックへの書き込みには明示的な許可が必要です。

• インストールされているコントローラースクリプトとPostfaderのバージョンが一致しない場合、書き込みはブロックされます。

• 応答が失われたり曖昧だったりした場合、書き込みが自動的に繰り返されることはありません。

• 提供されたセッションと変更前状態のチェックにより、古い判断を拒否できます。

• 選択された仮想MIDIバスを同時に使用できるローカルPostfader接続は1つのみです。

• コントローラースクリプトはFL Studioのプロジェクト保存機能を呼び出しません。

各書き込みの正確な動作については、Tool contractsを参照してください。

プラグインサポート

Postfaderは、FL Studioがコントローラースクリプトに公開するパラメータを持つ、あらゆるミキサーエフェクトまたはChannel Rackジェネレーターで動作します。これには、Image-Line製のネイティブプラグインや、多くのVST、VST3、AUプラグインが含まれます。

互換性は意図的に正直に扱われます：

• 馴染みのないプラグインは、Postfaderに追加する前に検査できます。

• FLが公開しないパラメータは制御できません。

• 非常に大きなパラメータマップは明示的な制限付きでスキャンされます。

• FLが受け入れるが無視する書き込みは、未検証として報告されます。

• 名前付きオプションは、FL Studioが報告する正確なラベルを使用する必要があります（大文字と小文字は区別されません）。

パラメータの発見、オプション検索、スキャン制限、トラブルシューティング、コミュニティのエビデンス形式については、Plug-in supportを参照してください。

重要な制限事項

Postfaderは現在、以下を行うことはできません：

• プラグインの追加、削除、並べ替え。

• エフェクトスロットのバイパスやウェット/ドライミックスを確実に制御。

• FL Studioのライブ出力を聞く。

• プロジェクトのレンダリング、エクスポート、保存。

• ミックスが良いかどうかを判断。

• 生のPlaylist選択エンドポイントを安全な自動レンダリング範囲に変換。

オーディオツールは、明示的に選択したファイルや、制限されたFL Studioフォルダ内で見つかった最近のバウンスを分析します。オーディオサンプルや芸術的判断ではなく、測定値と比較結果を返します。

ローカルの仮想MIDIバスは共有されており、認証されていません。信頼できる単一ユーザーのワークステーションでPostfaderを使用してください。

プライバシー

Postfader自体はローカルで実行され、テレメトリやクラウドサービスはありません。このリポジトリにプロジェクト、録音、ステム、プリセット、エクスポート、ライブセッションのエビデンスを保存することはありません。

AIクライアントは別のアプリケーションであり、ツールの引数と結果をモデルプロバイダーに送信する場合があります。オーディオ結果にはファイルパス、ハッシュ、測定値が含まれることがありますが、オーディオサンプルが含まれることはありません。機密性の高いプロジェクトを使用する前に、AIクライアントのプライバシーポリシーとPostfaderのセキュリティポリシーを確認してください。

ドキュメント

開発

ソースチェックアウトから、安全でハードウェア不要のテストスイートを実行します：

./.venv/bin/python scripts/run_safe_tests.py

.\.venv\Scripts\python.exe scripts\run_safe_tests.py

安全なスイートは、環境変数が要求しても実際のMIDIアクセスを防ぎます。ライブハードウェアテストは、空の未保存プロジェクトを使用する必要があり、そのログ、スクリーンショット、実行メモは公開リポジトリの外に置く必要があります。

ライセンス

PostfaderはApache License 2.0の下で利用可能です。帰属の詳細についてはNOTICEを参照してください。