FL Studio MCP Bridge

Paquete para conectar un chat compatible con MCP a FL Studio en Windows.

Que incluye

• mcp-server/fl_mcp_server.py: servidor MCP externo.

• fl-studio-hardware-script/device_MCPBridge.py: script MIDI que va dentro de FL Studio.

• mcp-server/fl_http_bridge.py: puente HTTP auxiliar/legacy incluido por compatibilidad.

• requirements.txt: dependencia Python principal.

• claude_desktop_config.example.json: ejemplo de configuracion MCP.

Related MCP server: flemcee

Requisitos

1. Windows.

2. FL Studio abierto.

3. Python 3.9 o superior.

4. loopMIDI instalado.

5. Dos puertos loopMIDI creados exactamente con estos nombres:

   • MCP Bridge

   • MCP Notes

Instalacion

1. Instalar dependencias Python

Abre PowerShell en la carpeta mcp-server y ejecuta:

python -m pip install -r ..\requirements.txt

2. Instalar el script MIDI en FL Studio

Copia:

fl-studio-hardware-script\device_MCPBridge.py

a:

%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\MCP Bridge\device_MCPBridge.py

Si la carpeta MCP Bridge no existe, creala.

3. Activar en FL Studio

En FL Studio:

1. Ve a Options > MIDI Settings.

2. En Input, activa el puerto MCP Bridge.

3. Asignale el script/controlador MCP Bridge.

4. Activa tambien MCP Notes como controlador generico, sin script.

Importante: MCP Bridge dispara CC119 para que FL lea fl_request.json; MCP Notes manda notas MIDI reales al Piano Roll.

4. Configurar el cliente MCP

Usa el archivo claude_desktop_config.example.json como base y cambia las rutas si hace falta.

Ejemplo:

{
  "mcpServers": {
    "fl-studio": {
      "command": "C:\\Users\\TU_USUARIO\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": ["C:\\ruta\\a\\fl-studio-mcp-bridge\\mcp-server\\fl_mcp_server.py"]
    }
  }
}

Prueba rapida

Con FL Studio abierto y el script activo, pide al chat:

Prueba la conexion con FL Studio usando fl_status.

Si todo esta bien, debe devolver BPM, estado de reproduccion, patron actual, cantidad de canales y mixer tracks.

Herramientas principales

• fl_status

• fl_get_bpm

• fl_set_bpm

• fl_list_channels

• fl_list_mixer

• fl_list_patterns

• fl_add_notes

• fl_show_window

• fl_play

• fl_stop

• fl_record

• fl_rewind

Notas tecnicas

• El IPC usa archivos JSON en:

%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\MCP Bridge

• fl_request.json: request del servidor MCP hacia FL.

• fl_response.json: respuesta de FL hacia el servidor MCP.

• CC119 por MCP Bridge despierta el script MIDI.

• MCP Notes se usa para grabar notas MIDI en el Piano Roll.

• PPQ usado por el bridge: 96 ticks por beat.

• En este bridge, MIDI 60 = C5.