flstudiomcp

# flstudiomcp A standalone Model Context Protocol (MCP) server that provides AI agents with direct control over FL Studio via a local TCP socket bridge. ## Architecture This project consists of two parts: 1. **The FL Studio MIDI Script (`midi_script/device_mcp.py`)**: Runs *inside* FL Studio's embedded Python engine, listening on a non-blocking TCP socket (`localhost:8080`) for incoming instructions. 2. **The MCP Server (`mcp_server/server.py`)**: A standard FastMCP Python server that translates AI tool calls (like `fl_play()`) into JSON payloads and sends them to the MIDI script. ## Installation & Setup ### 1. Install the MIDI Script To allow the MCP Server to talk to FL Studio, you must install the provided Python MIDI script. 1. Navigate to your FL Studio User Data folder: `Documents\Image-Line\FL Studio\Settings\Hardware` 2. Create a new folder named `MCP_Server` 3. Copy the `midi_script/device_mcp.py` file into the new `MCP_Server` folder. 4. Open FL Studio and press `F10` to open Settings. 5. Go to the **MIDI** tab. 6. In the Output/Input list, select any generic/dummy controller (or your main controller). In the **Controller type** dropdown, select `MCP Server`. 7. FL Studio will load the script, and it will begin listening on `localhost:8080`. ### 2. Run the MCP Server 1. Ensure you have Python installed. 2. Install the MCP SDK: ```bash pip install mcp ``` 3. Run the MCP server via stdio: ```bash python mcp_server/server.py ```