FL Studio MCP Server

Control FL Studio using natural language through Claude AI via the Model Context Protocol (MCP).

Features

• Transport Control: Play, stop, record, get playback state
• Pattern Management: Create, select, and rename patterns
• Channel Rack: View all channels with volume, pan, mute status
• Mixer Info: Get mixer track information

Requirements

• FL Studio (Windows/macOS)
• Node.js 18+
• Virtual MIDI Driver:
  • Windows: loopMIDI
  • macOS: Use IAC Driver (built-in) - see instructions below
  • Linux: Use ALSA virtual MIDI ports

Installation

1. Clone and Build

git clone https://github.com/your-repo/fl-studio-mcp.git
cd fl-studio-mcp
npm install
npm run build

2. Set Up Virtual MIDI Ports

Windows (loopMIDI)

1. Install loopMIDI
2. Create two ports:
   • FL Bridge In (commands to FL Studio)
   • FL Bridge Out (responses from FL Studio)

macOS (IAC Driver)

1. Open Audio MIDI Setup (Applications > Utilities)
2. Show MIDI Studio (Window > Show MIDI Studio)
3. Double-click IAC Driver
4. Check “Device is online”
5. Add two ports:
   • FL Bridge In
   • FL Bridge Out

Linux (ALSA)

sudo modprobe snd-virmidi
# Creates virtual MIDI ports accessible via ALSA

3. Install FL Bridge Script

Copy the fl-bridge folder to FL Studio’s Hardware folder:

• Windows: Documents\Image-Line\FL Studio\Settings\Hardware\FLBridge\
• macOS: Documents/Image-Line/FL Studio/Settings/Hardware/FLBridge/

The folder should contain:

FLBridge/
├── device_FLBridge.py
├── protocol/
│   ├── __init__.py
│   ├── sysex.py
│   └── commands.py
└── handlers/
    ├── __init__.py
    ├── transport.py
    ├── state.py
    └── patterns.py

4. Configure FL Studio MIDI Settings

1. Open FL Studio
2. Go to OPTIONS > MIDI settings
3. Click “Rescan MIDI devices” or “Update MIDI scripts”

Input Section:

• Select FL Bridge In
• Set Controller type to FL Bridge
• Assign Port 0

Output Section:

• Select FL Bridge Out
• Assign Port 0

Critical: Both input and output must have the same port number (e.g., Port 0) for FL Studio to link them correctly.

5. Configure Claude Code

Create .mcp.json in your project directory:

{
  "mcpServers": {
    "fl-studio": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/fl-studio-mcp/dist/index.js"],
      "env": {
        "FL_PORT_TO_FL": "FL Bridge In",
        "FL_PORT_FROM_FL": "FL Bridge Out"
      }
    }
  }
}

Environment Variables: