FL Studio 2025 AI Bridge (fLMCP-2025)

A Model Context Protocol (MCP) bridge that lets an AI assistant (Claude, or any MCP client) read and control FL Studio — extended to actually work on FL Studio 2025 (build 25.2.5), whose locked-down control-script sandbox breaks every socket-based FL bridge.

Attribution

This project is a derivative of geezoria/FLStudioMCP (MIT), which provides the 159-tool MCP server and the FL-side device script. All original credit goes to that project — see LICENSE. This repo adds the FL Studio 2025 compatibility layer and a few new capabilities (below).

Why this fork exists

On FL Studio 2025 build 25.2.5, control-surface scripts run in a CPython sub-interpreter that blocks threads, sockets, and most os filesystem calls, and never calls OnIdle — so the upstream TCP bridge cannot even open its port. Full diagnosis (with every error, reproduced): docs/FL2025_SANDBOX.md.

This fork makes the bridge work anyway, using only the primitives FL 2025 does allow:

Verified working on FL Studio 2025 build 25.2.5: reads (project/transport/ channels/mixer), writes (tempo, step-sequencer beats, mixer), note recording, and audio analysis.

Related MCP server: FL Studio MCP Server

Quick start (Windows, FL Studio 2025)

git clone https://github.com/Boyan253/fl-studio-2025-ai-bridge.git
cd fl-studio-2025-ai-bridge
./scripts/install_windows.ps1

Then in FL Studio:

1. Install loopMIDI and create a port (e.g. loopMIDI Port).

2. Options > MIDI settings > Input: select the loopMIDI port and set Controller type = fLMCP Bridge (it appears in the "Scripts" section near the top — not alphabetically).

3. Set FLMCP_TRANSPORT=file in your MCP client's env for this server (and FLMCP_MIDI_PORT if your port name differs from loopMIDI).

Smoke test:

$env:FLMCP_TRANSPORT="file"
.\.venv\Scripts\python.exe scripts\smoke_test.py

What works vs. doesn't on FL 2025 25.2.5

• ✅ Reads, transport/mixer control, step-sequencer beats, tempo, note recording, audio analysis

• ❌ Direct piano-roll editing (pianoroll.*) — the sandbox blocks its file staging (use note recording instead)

• ❌ Playlist clip placement — limited by FL's public API

See docs/FL2025_SANDBOX.md for the complete story.

License

MIT — see LICENSE. Original work © the FLStudioMCP authors (geezoria/FLStudioMCP); FL-2025 additions contributed on top.