Skip to content

GoBeromsu/XM32-MCP

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

X32/M32 MCP Server

MCP server for controlling Behringer X32/M32 digital mixing consoles via OSC protocol.

When to Use This

  • Remote Mixing: Control your X32/M32 from anywhere on the network
  • Automated Setup: Quickly configure channels for rehearsals or shows
  • Batch Operations: Apply settings to multiple channels at once
  • Documentation: Query and document current mixer settings
  • Troubleshooting: Check mixer state without physical access
  • Live Adjustments: Make quick changes during performances via AI assistant

Features

  • 32 input channels with volume, gain, mute, solo, EQ, pan control
  • 16 mix buses for aux sends and monitor mixes
  • 8 FX racks with parameter control
  • Main/monitor output control
  • Direct OSC parameter access for advanced users

Installation

npm install -g x-m32-mcp-server

Or from source:

git clone https://github.com/GoBeromsu/X32-MCP.git
cd X32-MCP
npm install && npm run build

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "x32": {
            "command": "npx",
            "args": ["x-m32-mcp-server"]
        }
    }
}

Connect to Mixer

connection_connect with host="192.168.1.100" and port=10023

Available Tools (21 total)

Tool Parameters
Connection (4)
connection_connect host, port
connection_disconnect -
connection_get_info -
connection_get_status -
Channel (8)
channel_set_volume channel, value, unit
channel_set_gain channel, gain
channel_mute channel, muted
channel_solo channel, solo
channel_set_name channel, name
channel_set_color channel, color
channel_set_pan channel, pan
channel_set_eq_band channel, band, parameter, value
Bus (4)
bus_set_volume bus, value, unit
bus_mute bus, muted
bus_set_send channel, bus, value, unit
bus_get_state bus
FX (3)
fx_set_parameter fx, parameter, value
fx_get_state fx
fx_bypass fx, bypass
Main/Monitor (3)
main_set_volume value, unit
main_mute muted
monitor_set_level value, unit
Low-Level (2)
get_parameter address
set_parameter address, value

Quick Tips

  • Unity Gain: 0 dB = 0.75 linear (neutral, no boost/cut)
  • Safe Start: Begin with channel at -20 dB and muted
  • Channel Colors: Use colors to organize (red=vocals, blue=drums, etc.)
  • Bus Usage: 1-4 monitors, 5-6 FX sends, 7-8 recording, 9-16 IEM/matrix
  • Network: X32 uses port 10023, connect to same network as computer

Parameter Reference

Common Parameters

  • channel: 1-32
  • bus: 1-16
  • fx: 1-8
  • unit: "linear" (0.0-1.0) or "db" (-90 to +10)
  • muted/solo/bypass: true/false
  • pan: -100 to +100, "L50"/"C"/"R50", or 0.0-1.0
  • color: "red", "green", "blue", etc. or 0-15
  • band: 1-4 (EQ bands)
  • parameter: "f" (frequency), "g" (gain), "q" (Q factor)

Value Ranges

  • Volume linear: 0.0-1.0 (unity = 0.75)
  • Volume dB: -90 to +10 (unity = 0 dB)
  • Gain: 0.0-1.0
  • FX parameter: 0.0-1.0
  • Channel name: max 12 characters

License

MIT

Support

https://github.com/GoBeromsu/X32-MCP

About

X/M32-MCP

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 98.0%
  • JavaScript 2.0%