FL Studio Agent

FL Studio エージェント

AI エージェントから FL Studio を操作します。 fl-studio-agent は MCP サーバー、Python SDK、ネイティブの Bridge プラグインです。エージェントがノートを書き込み、テンポ、レベル、プラグインパラメーターを設定し、音が鳴っているチャンネルを確認して、ミックスをレンダリングします。すべてご自身の FL Studio で行えます。

Claude Code：

claude mcp add --scope user fl-studio -- uvx --python 3.12 fl-studio-agent

クイックスタート

macOS または Windows の FL Studio 2026 と uv が必要です。

1. uv をインストールします。まだインストールしていない場合は、以下を実行してください。 macOS：curl -LsSf https://astral.sh/uv/install.sh | sh。 Windows：powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" を実行し、続いて loopMIDI をインストールして、FLMCP Req と FLMCP Res という名前のポートを 2 つ追加してください（Windows には仮想 MIDI ポートがありません。macOS では何も必要ありません）。

2. FL Studio を一度セットアップします。まだ FL Studio を起動したことがない場合は、一度起動してから終了し、以下を実行してください（Windows では、FL のプラグインフォルダーが Program Files の下にあるため、管理者として開いたターミナルで実行してください）。

   uvx --python 3.12 --from fl-studio-agent fl-mcp-install
   

   コントローラーとノートのスクリプトをインストールし、コントローラーの MIDI ポートを割り当て、エージェント専用のプロジェクト（FLMCP Agent.flp。ほかのプロジェクトには一切触れません）を作成します。また、ライブ書き込みと render に使用するビルド済みの Bridge プラグイン をダウンロードし、リリースの SHA-256 チェックサムと照合します。 再実行しても問題ありません。 後で更新するには、fl-studio-agent の代わりに fl-studio-agent@latest を指定して実行し、FL とクライアントを再起動してください。

3. 上のボタンまたは以下の設定を使ってサーバーをクライアントに追加し、FL Studio を開いて、「A マイナーの 4 小節のコードループを作って」と依頼してください。

claude mcp add --scope user fl-studio -- uvx --python 3.12 fl-studio-agent

{
  "mcpServers": {
    "fl-studio": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "fl-studio-agent"
      ]
    }
  }
}

{
  "mcpServers": {
    "fl-studio": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "fl-studio-agent"
      ]
    }
  }
}

code --add-mcp '{"name": "fl-studio", "type": "stdio", "command": "uvx", "args": ["--python", "3.12", "fl-studio-agent"]}'

{
  "mcpServers": {
    "fl-studio": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "fl-studio-agent"
      ]
    }
  }
}

トラブルシューティング

FL Studio を開いた状態で診断ツールを実行してください。

uvx --python 3.12 --from fl-studio-agent fl-mcp-doctor

コントロールプレーン（コントローラースクリプトと MIDI ポート）、ノートプレーン、エージェントプロジェクトについて、接続されていない項目の fix を含む JSON レポートを 1 つ出力します。 よくある解決方法：クライアントがサーバーを起動する前に FL Studio を開きます。アップグレード後は手順 2 を fl-studio-agent@latest で再実行します（古いコントローラーがある場合は報告されます）。Windows では loopMIDI を起動したままにし、両方のポートを維持してください。 FL Studio のトライアル版をお使いですか？トライアル版では保存済みプロジェクトを再度開けないため、サーバーの env に FLMCP_FL_LICENSE=trial を設定してください。 uvx --python 3.12 fl-studio-agent --version を実行すると、インストール済みのバージョンが表示されます。

ツール

サーバーは、各ジョブに対応する5つのツールを公開します。

基本的な作業の流れは、書き込み、節目での確認、最後のレンダリングです。 各結果には FL の現在の状態が反映されるため、待機、保存、再読み込みは不要です。 FL による一時的な拒否（「operation unsafe at current time」や制御ワイヤーのビジー状態）はエンジン内部で再試行されるため、モデルには対処可能なエラーのみが表示されます。 セットアップ診断はオペレーター向けであり、モデル向けではありません。fl-mcp-doctor を実行すると、同じレポートが JSON 形式で出力されます。

仕組み

3つの連携するレーンで構成されています。 flpkit はプロジェクトファイルを編集し、ネイティブの Bridge プラグインはホスト上でライブ操作を行い、MIDI コントローラースクリプトはコントローラーのライブ操作を処理します。 SETUP.md では、ソースチェックアウトからのインストールと Bridge のビルドについて説明しています。

開発

使い捨てのライブスモークセッションには、fl-mcp-dev-session を実行してください。ローカルのマージゲートを実行するには、次のコマンドを実行してください。

scripts/gate.sh

ゲートは、テスト数と検証要件を確定する基準です。現在のステージについては、docs/gate.md を参照してください。

ドキュメント

• SETUP.md：ソースからのインストール、Bridge プラグイン、Windows。
• docs/README.md：最新のドキュメント一覧。
• docs/24-coverage-map.md：機能の対応状況。
• RUNBOOK_E2E.md：エンドツーエンド検証。