Servidor MCP de FL Studio

Un servidor MCP (Model Context Protocol) que permite a los asistentes de IA controlar FL Studio a través de comunicación MIDI y scripts de Piano Roll.

Demo rápida

No prestes atención al audio, tuve que recortarlo con mi micrófono porque Apple no me dejaba grabar el audio del escritorio jajaja

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

Audio original

Si quieres escuchar el audio con mejor calidad

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

Características

Control de transporte

• Reproducir, pausar, detener la reproducción

• Alternar grabación

• Establecer posición de reproducción

• Obtener longitud y posición de la canción

• Controlar modo de bucle (patrón/canción)

• Ajustar velocidad de reproducción

Control del mezclador

• Obtener/establecer volumen y panorama de pista

• Silenciar/solo en pistas

• Armar pistas para grabación

• Establecer nombres y colores de pista

• Control de separación estéreo

Control del rack de canales

• Listar todos los canales

• Obtener/establecer propiedades de canal (volumen, panorama, nombre, color)

• Silenciar/solo en canales

• Enrutar canales a pistas del mezclador

• Disparar notas MIDI en tiempo real

• Control del secuenciador por pasos (obtener/establecer bits de rejilla)

Control de plugins

• Listar parámetros de plugin

• Obtener/establecer valores de parámetros

• Navegar por presets (siguiente/anterior)

• Consultar información del plugin

Control del Piano Roll

• Añadir notas al piano roll con sincronización precisa

• Añadir acordes con un solo comando

• Eliminar notas específicas por número MIDI y tiempo

• Borrar todas las notas del piano roll

• Leer el estado del piano roll para ver todas las notas existentes

• Disparo automático mediante pulsación de teclas (Cmd+Opt+Y en macOS, Ctrl+Alt+Y en Windows)

Related MCP server: FL Studio MCP Server

Limitaciones importantes

No se pueden cargar plugins

La API de scripting de FL Studio no admite la carga de nuevos plugins VST/AU. Solo puedes controlar los parámetros de los plugins que ya están cargados en tu proyecto.

No se pueden crear patrones

No existe una API para crear nuevos patrones mediante programación. Solo puedes trabajar con patrones existentes.

Requisitos

• FL Studio 20.7+ (API de scripting de controlador MIDI)

• Python 3.10+

• macOS o Windows

  • macOS: Controlador IAC (integrado, debe estar habilitado)

  • Windows: loopMIDI

Instalación rápida

La forma más fácil de instalar es usando el script de configuración proporcionado:

# 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

Esto hará lo siguiente:

1. Instalar uv si no está presente

2. Instalar dependencias de Python

3. Guiarte a través de la habilitación de puertos MIDI virtuales (Controlador IAC en Mac)

4. Instalar el script de controlador MIDI de FL Studio

5. Instalar el script de Piano Roll (ComposeWithLLM)

6. Configurar Claude Desktop o Claude Code automáticamente

Instalación manual

1. Instalar dependencias de Python

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

2. Habilitar puertos MIDI virtuales

macOS (Controlador IAC)

1. Abre Configuración de Audio MIDI (busca en Spotlight)

2. Presiona Cmd+2 o ve a Ventana > Mostrar estudio MIDI

3. Haz doble clic en Controlador IAC

4. Marca "El dispositivo está en línea"

5. Haz clic en Aplicar

Windows (loopMIDI)

1. Descarga e instala loopMIDI

2. Crea un puerto virtual (cualquier nombre funciona)

3. Mantén loopMIDI ejecutándose mientras usas FL Studio

3. Instalar scripts de FL Studio

Copia el script del controlador a la carpeta Hardware de 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\"

Copia el script de Piano Roll:

# 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. Configurar FL Studio

1. Reinicia FL Studio (si se está ejecutando)

2. Ve a Opciones > Configuración MIDI

3. En Entrada, busca tu puerto MIDI virtual (ej. "IAC Driver Bus 1")

4. Establece el Tipo de controlador en FLStudioMCP

5. Habilita el puerto (haz clic para resaltarlo)

5. Configurar Claude

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

O para Claude Code, añade a tus ajustes de MCP.

Uso

Ejecutar el servidor manualmente

# Using uv
uv run fl-studio-mcp

# Or after installation
fl-studio-mcp

Flujo de trabajo del Piano Roll

1. Abre FL Studio y selecciona un canal

2. Abre el Piano Roll (F7 o haz doble clic en el canal)

3. La primera vez, ejecuta manualmente el script: Herramientas > Scripting > ComposeWithLLM

4. Después de eso, las herramientas MCP dispararán el script automáticamente

Herramientas disponibles

Conexión

Transporte

Mezclador

Canales

Plugins

Piano Roll

Ejemplos de flujos de trabajo

Ajustar una mezcla

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

Crear un patrón de batería

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

Añadir una melodía al Piano Roll

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

Añadir acordes

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

Automatizar parámetros de plugins

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

Solución de problemas

"No conectado a FL Studio"

1. Asegúrate de que FL Studio esté ejecutándose

2. Comprueba que el controlador FLStudioMCP esté habilitado en la Configuración MIDI

3. En Mac, verifica que el Controlador IAC esté habilitado en Configuración de Audio MIDI

4. En Windows, verifica que loopMIDI se esté ejecutando

5. Reinicia FL Studio después de habilitar el controlador

"Tiempo de espera agotado esperando respuesta de FL Studio"

1. Asegúrate de que FL Studio esté en primer plano

2. Comprueba la ventana de salida de Script en FL Studio (Ver > Salida de script)

3. Verifica que el controlador esté recibiendo MIDI (busca actividad en la Configuración MIDI)

El script de Piano Roll no se dispara

1. Primera vez: ejecuta manualmente Herramientas > Scripting > ComposeWithLLM en FL Studio

2. En macOS: otorga permisos de Accesibilidad cuando se solicite

3. Asegúrate de que FL Studio esté en primer plano al disparar

4. Intenta presionar Cmd+Opt+Y (macOS) o Ctrl+Alt+Y (Windows) manualmente

No hay puertos MIDI disponibles

• macOS: Habilita el Controlador IAC en Configuración de Audio MIDI

• Windows: Instala y ejecuta loopMIDI

Arquitectura

Este servidor MCP utiliza un enfoque híbrido:

┌─────────────────┐     ┌─────────────────────────────────────────┐
│   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) │ │
                        │  └──────────────┘  └──────────────────┘ │
                        └─────────────────────────────────────────┘

Cómo funciona

1. Transporte/Mezclador/Canales/Plugins:

   • El servidor MCP escribe el comando en un archivo JSON

   • Envía una nota de disparo MIDI a FL Studio

   • El script del controlador de FL Studio lee el JSON, ejecuta la API, escribe la respuesta

   • El servidor MCP lee la respuesta

2. Piano Roll:

   • El servidor MCP escribe solicitudes de notas en un archivo JSON

   • Envía una pulsación de tecla (Cmd+Opt+Y) para disparar el script de FL Studio

   • El script de Piano Roll lee el JSON y modifica las notas

Desarrollo

Requisitos previos

• Python 3.10+

• uv (recomendado)

Configuración

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

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

Comandos disponibles

Estructura del proyecto

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

Créditos

• FL Studio API Stubs - Documentación de la API

• FastMCP - Framework de servidor MCP

• mido - Biblioteca MIDI para Python

• calvinw/fl-studio-mcp - Enfoque de integración de Piano Roll

• Image-Line - FL Studio

Licencia

MIT