Configuration¶

Configuration options for FL Studio MCP Server.

Server Configuration¶

MIDI Port Name¶

By default, the server uses FLStudio_MIDI as the MIDI port name. To use a different port:

# When initializing the server
from fruityloops_mcp.server import FLStudioMCPServer

server = FLStudioMCPServer(midi_port="MyCustomPort")

MCP Client Configuration¶

Claude Desktop¶

Location of config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Basic configuration:

{
  "mcpServers": {
    "fruityloops": {
      "command": "uvx",
      "args": ["fruityloops-mcp"]
    }
  }
}

With custom port:

{
  "mcpServers": {
    "fruityloops": {
      "command": "uv",
      "args": ["run", "fruityloops-mcp"],
      "env": {
        "MIDI_PORT": "MyCustomPort"
      }
    }
  }
}

FL Studio Configuration¶

MIDI Settings¶

Open FL Studio
Options → MIDI Settings
Enable your MIDI port (e.g., FLStudio_MIDI)
Set as:
Input: Enabled
Output: Enabled
Controller type: Generic Controller

Python API¶

The Python API is automatically available in FL Studio. No additional configuration needed.

loopMIDI Configuration¶

Port Settings¶

Port name: FLStudio_MIDI (must match server configuration)
Autostart: Enabled (optional)

Multiple Ports¶

You can create multiple virtual MIDI ports for different purposes:

FLStudio_MIDI  - Main control
FLStudio_Drums - Drum sequencer
FLStudio_Synth - Synthesizer control

Then connect to specific ports as needed.

Environment Variables¶

MIDI_PORT¶

Set default MIDI port name:

export MIDI_PORT=MyCustomPort

LOG_LEVEL¶

Set logging level:

export LOG_LEVEL=DEBUG  # DEBUG, INFO, WARNING, ERROR

Advanced Configuration¶

Custom Server Script¶

Create a custom script to configure the server:

#!/usr/bin/env python
import asyncio
import logging
from fruityloops_mcp.server import FLStudioMCPServer

# Configure logging
logging.basicConfig(level=logging.DEBUG)

# Create server with custom port
server = FLStudioMCPServer(midi_port="MyPort")

# Run server
asyncio.run(server.run())

Make executable and use in MCP config:

{
  "mcpServers": {
    "fruityloops": {
      "command": "/path/to/custom_server.py"
    }
  }
}

Configuration Files¶

The server doesn't use configuration files by default. All configuration is done through:

Command-line arguments
Environment variables
MCP client configuration

Troubleshooting¶

Port Not Found¶

If you get "Port not found" errors:

Check loopMIDI is running
Verify port name matches exactly
List available ports with midi_list_ports()

Permission Issues¶

On some systems, you may need additional permissions for MIDI access.

Linux:

sudo usermod -a -G audio $USER

macOS: Grant MIDI permissions in System Preferences