FL Studio MCP Server

Ein MCP-Server (Model Context Protocol), der es KI-Assistenten ermöglicht, FL Studio über MIDI-Kommunikation und Piano-Roll-Skripte zu steuern.

Kurze Demo

Ignorieren Sie den schlechten Ton, ich musste mit meinem Mikrofon aufnehmen, da Apple mich den Desktop-Ton nicht aufnehmen ließ lol

https://github.com/user-attachments/assets/d4fc668f-9fe5-4ab4-9f18-76cd661029c6

Original-Audio

Falls Sie das bessere Audio hören möchten

https://github.com/user-attachments/assets/c2b1a5e7-1640-41fa-82bc-18ca7cbae9e8

Funktionen

Transportsteuerung

• Wiedergabe starten, pausieren, stoppen

• Aufnahme umschalten

• Wiedergabeposition festlegen

• Songlänge und -position abrufen

• Loop-Modus steuern (Pattern/Song)

• Wiedergabegeschwindigkeit anpassen

Mixer-Steuerung

• Lautstärke und Panorama von Tracks abrufen/festlegen

• Tracks stummschalten/solo schalten

• Tracks für die Aufnahme scharfschalten

• Track-Namen und -Farben festlegen

• Steuerung der Stereobreite

Channel Rack-Steuerung

• Alle Kanäle auflisten

• Kanaleigenschaften abrufen/festlegen (Lautstärke, Panorama, Name, Farbe)

• Kanäle stummschalten/solo schalten

• Kanäle auf Mixer-Tracks routen

• MIDI-Noten in Echtzeit auslösen

• Step-Sequencer-Steuerung (Grid-Bits abrufen/festlegen)

Plugin-Steuerung

• Plugin-Parameter auflisten

• Parameterwerte abrufen/festlegen

• Presets navigieren (nächstes/vorheriges)

• Plugin-Informationen abfragen

Piano Roll-Steuerung

• Noten hinzufügen zum Piano Roll mit präzisem Timing

• Akkorde hinzufügen mit einem einzigen Befehl

• Bestimmte Noten löschen nach MIDI-Nummer und Zeit

• Alle Noten löschen aus dem Piano Roll

• Piano Roll-Status lesen, um alle vorhandenen Noten zu sehen

• Automatische Auslösung per Tastendruck (Cmd+Opt+Y auf macOS, Strg+Alt+Y auf Windows)

Related MCP server: FL Studio MCP Server

Wichtige Einschränkungen

Plugins können nicht geladen werden

Die FL Studio Scripting API unterstützt nicht das Laden neuer VST/AU-Plugins. Sie können nur Parameter von Plugins steuern, die bereits in Ihrem Projekt geladen sind.

Patterns können nicht erstellt werden

Es gibt keine API, um programmgesteuert neue Patterns zu erstellen. Sie können nur mit bestehenden Patterns arbeiten.

Anforderungen

• FL Studio 20.7+ (MIDI Controller Scripting API)

• Python 3.10+

• macOS oder Windows

  • macOS: IAC-Treiber (integriert, muss aktiviert werden)

  • Windows: loopMIDI

Schnelle Installation

Der einfachste Weg zur Installation ist die Verwendung des bereitgestellten Setup-Skripts:

# Clone the repository
git clone https://github.com/karl-andres/fl-studio-mcp.git
cd fl-studio-mcp

# Run the one-command installer
./install.sh

Dies wird:

1. uv installieren, falls nicht vorhanden

2. Python-Abhängigkeiten installieren

3. Sie durch die Aktivierung virtueller MIDI-Ports führen (IAC-Treiber auf Mac)

4. Das FL Studio MIDI-Controller-Skript installieren

5. Das Piano Roll-Skript installieren (ComposeWithLLM)

6. Claude Desktop oder Claude Code automatisch konfigurieren

Manuelle Installation

1. Python-Abhängigkeiten installieren

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

2. Virtuelle MIDI-Ports aktivieren

macOS (IAC-Treiber)

1. Öffnen Sie Audio-MIDI-Setup (Suche in Spotlight)

2. Drücken Sie Cmd+2 oder gehen Sie zu Fenster > MIDI-Studio einblenden

3. Doppelklicken Sie auf IAC-Treiber

4. Aktivieren Sie "Gerät ist online"

5. Klicken Sie auf Anwenden

Windows (loopMIDI)

1. Laden Sie loopMIDI herunter und installieren Sie es

2. Erstellen Sie einen virtuellen Port (jeder Name funktioniert)

3. Lassen Sie loopMIDI laufen, während Sie FL Studio verwenden

3. FL Studio-Skripte installieren

Kopieren Sie das Controller-Skript in den Hardware-Ordner von FL Studio:

# macOS
mkdir -p ~/Documents/Image-Line/FL\ Studio/Settings/Hardware/FLStudioMCP
cp fl_controller/device_FLStudioMCP.py ~/Documents/Image-Line/FL\ Studio/Settings/Hardware/FLStudioMCP/

# Windows
mkdir "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\FLStudioMCP"
copy fl_controller\device_FLStudioMCP.py "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\FLStudioMCP\"

Kopieren Sie das Piano Roll-Skript:

# macOS
cp scripts/ComposeWithLLM.pyscript ~/Documents/Image-Line/FL\ Studio/Settings/Piano\ roll\ scripts/

# Windows
copy scripts\ComposeWithLLM.pyscript "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Piano roll scripts\"

4. FL Studio konfigurieren

1. Starten Sie FL Studio neu (falls es läuft)

2. Gehen Sie zu Optionen > MIDI-Einstellungen

3. Suchen Sie unter Eingabe Ihren virtuellen MIDI-Port (z. B. "IAC Driver Bus 1")

4. Setzen Sie den Controllertyp auf FLStudioMCP

5. Aktivieren Sie den Port (klicken Sie darauf, um ihn hervorzuheben)

5. Claude konfigurieren

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS):

{
  "mcpServers": {
    "fl-studio": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/fl-studio-mcp", "fl-studio-mcp"]
    }
  }
}

Oder fügen Sie es für Claude Code zu Ihren MCP-Einstellungen hinzu.

Verwendung

Server manuell ausführen

# Using uv
uv run fl-studio-mcp

# Or after installation
fl-studio-mcp

Piano Roll-Workflow

1. Öffnen Sie FL Studio und wählen Sie einen Kanal aus

2. Öffnen Sie das Piano Roll (F7 oder Doppelklick auf den Kanal)

3. Führen Sie beim ersten Mal das Skript manuell aus: Tools > Scripting > ComposeWithLLM

4. Danach lösen die MCP-Tools das Skript automatisch aus

Verfügbare Tools

Verbindung

Transport

Mixer

Kanäle

Plugins

Piano Roll

Beispiel-Workflows

Einen Mix anpassen

"Set the volume of mixer track 1 to 80% and pan it slightly left"

Ein Drum-Pattern erstellen

"Create a basic kick pattern on channel 0 with kicks on steps 0, 4, 8, and 12"

Eine Melodie zum Piano Roll hinzufügen

"Add a C major arpeggio starting at beat 0: C4, E4, G4, C5 - each note quarter duration"

Akkorde hinzufügen

"Add a C major chord at beat 0, then F major at beat 2, then G major at beat 4"

Plugin-Parameter automatisieren

"List the parameters of the plugin on channel 0 and set the filter cutoff to 50%"

Fehlerbehebung

"Nicht mit FL Studio verbunden"

1. Stellen Sie sicher, dass FL Studio läuft

2. Prüfen Sie, ob der FLStudioMCP-Controller in den MIDI-Einstellungen aktiviert ist

3. Prüfen Sie auf dem Mac, ob der IAC-Treiber in den Audio-MIDI-Einstellungen aktiviert ist

4. Prüfen Sie unter Windows, ob loopMIDI läuft

5. Starten Sie FL Studio nach dem Aktivieren des Controllers neu

"Zeitüberschreitung beim Warten auf FL Studio-Antwort"

1. Stellen Sie sicher, dass FL Studio im Fokus ist

2. Prüfen Sie das Skript-Ausgabefenster in FL Studio (Ansicht > Skript-Ausgabe)

3. Überprüfen Sie, ob der Controller MIDI empfängt (achten Sie auf Aktivität in den MIDI-Einstellungen)

Piano Roll-Skript löst nicht aus

1. Erstes Mal: Führen Sie manuell Tools > Scripting > ComposeWithLLM in FL Studio aus

2. Auf macOS: Gewähren Sie bei Aufforderung Zugriffsberechtigungen

3. Stellen Sie sicher, dass FL Studio beim Auslösen im Fokus ist

4. Versuchen Sie, Cmd+Opt+Y (macOS) oder Strg+Alt+Y (Windows) manuell zu drücken

Keine MIDI-Ports verfügbar

• macOS: Aktivieren Sie den IAC-Treiber in den Audio-MIDI-Einstellungen

• Windows: Installieren und starten Sie loopMIDI

Architektur

Dieser MCP-Server verwendet einen hybriden Ansatz:

┌─────────────────┐     ┌─────────────────────────────────────────┐
│   MCP Client    │────▶│           FastMCP Server                │
│  (Claude, etc)  │     │                                         │
└─────────────────┘     │  ┌─────────────────┐  ┌──────────────┐  │
                        │  │ MIDI + JSON     │  │ Piano Roll   │  │
                        │  │ Tools           │  │ Tools (JSON) │  │
                        │  └────────┬────────┘  └──────┬───────┘  │
                        └───────────┼──────────────────┼──────────┘
                                    │                  │
                               MIDI + JSON        JSON Files +
                                    │              Keystroke
                                    ▼                  ▼
                        ┌─────────────────────────────────────────┐
                        │              FL Studio                   │
                        │  ┌──────────────┐  ┌──────────────────┐ │
                        │  │FLStudioMCP   │  │ Piano Roll Script│ │
                        │  │(MIDI Ctrl)   │  │ (ComposeWithLLM) │ │
                        │  └──────────────┘  └──────────────────┘ │
                        └─────────────────────────────────────────┘

Funktionsweise

1. Transport/Mixer/Kanäle/Plugins:

   • MCP-Server schreibt Befehl in JSON-Datei

   • Sendet MIDI-Trigger-Note an FL Studio

   • FL Studio-Controller-Skript liest JSON, führt API aus, schreibt Antwort

   • MCP-Server liest Antwort

2. Piano Roll:

   • MCP-Server schreibt Notenanfragen in JSON-Datei

   • Sendet Tastendruck (Cmd+Opt+Y), um FL Studio-Skript auszulösen

   • Piano Roll-Skript liest JSON und ändert Noten

Entwicklung

Voraussetzungen

• Python 3.10+

• uv (empfohlen)

Einrichtung

# Install all dependencies including dev extras
uv sync --dev

# Or with pip
pip install -e ".[dev]"

Verfügbare Befehle

Projektstruktur

fl-studio-mcp/
├── fl_controller/
│   └── device_FLStudioMCP.py   # FL Studio MIDI controller script (runs inside FL Studio)
├── scripts/
│   ├── setup.sh                 # FL Studio script installer
│   ├── install_mcp_for_claude.sh # Claude config installer
│   └── ComposeWithLLM.pyscript  # Piano Roll script (runs inside FL Studio)
├── src/fl_studio_mcp/
│   ├── server.py                # FastMCP server entry point
│   ├── tools/                   # MCP tool implementations
│   │   ├── channels.py
│   │   ├── mixer.py
│   │   ├── piano_roll.py
│   │   ├── plugins.py
│   │   └── transport.py
│   └── utils/
│       ├── connection.py        # FL Studio connection wrapper
│       ├── fl_trigger.py        # Piano roll keystroke trigger
│       └── midi_connection.py   # MIDI + JSON communication layer
└── install.sh                   # One-command installer

Credits

• FL Studio API Stubs - API-Dokumentation

• FastMCP - MCP-Server-Framework

• mido - MIDI-Bibliothek für Python

• calvinw/fl-studio-mcp - Ansatz zur Piano-Roll-Integration

• Image-Line - FL Studio

Lizenz

MIT