OSC MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OSC MCP Server set Kick channel fader to -5 dB"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
OSC MCP Server
MCP Server for controlling a Behringer X-Air XR18 digital mixer via Open Sound Control (OSC) protocol.
Features
18 input channels with fader, mute, EQ (4 bands), and bus sends
6 buses (monitor/aux) with fader and mute
Main LR output control
4 FX slots with send level and mute
Symbolic naming — refer to channels and buses by name (e.g. "Kick", "Drummer") instead of numbers
dB-to-float conversion — work in dB, the server handles the XR18's non-linear fader scale
Persistent connection — the server remembers the last mixer IP across sessions
Raw OSC escape hatch for any unsupported command
Related MCP server: X32/M32 MCP Server
Prerequisites
Python >= 3.11
uv package manager
A Behringer XR18 (or other X-Air mixer) on your local network
Installation
git clone https://github.com/darkwings/OSC_MCP.git
cd OSC_MCP
uv syncRunning the Server
# Run via stdio (used by MCP clients)
uv run osc-mcp
# Or use the MCP inspector for interactive testing
uv run mcp dev src/osc_mcp/server.pyAdding to an MCP Client
Claude Desktop
The easiest way is to use the built-in install command:
uv run mcp install src/osc_mcp/server.py --name "OSC Mixer"Alternatively, open Claude Desktop and go to Settings > Developer > Edit Config, then add:
{
"mcpServers": {
"osc-mcp": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/OSC_MCP", "osc-mcp"]
}
}
}Restart Claude Desktop after saving.
Claude Code
claude mcp add osc-mcp -- uv run --directory /absolute/path/to/OSC_MCP osc-mcpOr manually add to .mcp.json or ~/.claude/mcp.json:
{
"mcpServers": {
"osc-mcp": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/OSC_MCP", "osc-mcp"]
}
}
}Cursor
Go to Settings > MCP Servers > Add Server and use:
Type: stdio
Command:
uv run --directory /absolute/path/to/OSC_MCP osc-mcp
Generic MCP Client
Any MCP-compatible client can connect using the stdio transport:
uv run --directory /absolute/path/to/OSC_MCP osc-mcpReplace /absolute/path/to/OSC_MCP with the actual path where you cloned the repository.
Usage
Once the server is running in your MCP client:
Connect:
connect_mixer("192.168.1.1")— the IP is saved for future sessionsName your channels:
assign_channel_name(1, "Kick"),assign_bus_name(2, "Drummer")Control:
set_channel_fader("Kick", -5),set_channel_send_to_bus("Kick", "Drummer", -10)
On subsequent sessions, the server automatically reconnects to the last known mixer IP. If the mixer is unreachable (e.g. different network), the agent is prompted to ask for the new IP.
Available Tools
Tool | Description |
| Connect to mixer at IP:port |
| Name a channel (1-18) |
| Name a bus (1-6) |
| Show all name assignments |
| Set channel level in dB |
| Mute/unmute a channel |
| Query current channel level |
| Set bus level in dB |
| Mute/unmute a bus |
| Set channel→bus send level |
| Query channel→bus send level |
| Set main LR level |
| Mute/unmute main LR |
| Set EQ band parameters |
| Enable/disable channel EQ |
| Set FX send level |
| Mute/unmute FX send |
| Query mixer info |
| Send any raw OSC message |
Running Tests
uv run pytestLicense
Apache License 2.0
Available Tools
19 toolsassign_bus_nameA
Give a bus (1-6) a symbolic name, e.g. bus 2 = 'Drummer'.
Inputs: bus (required), name (required). Returns: result
assign_channel_nameB
Give a channel (1-18) a symbolic name, e.g. channel 1 = 'Kick'.
Inputs: name (required), channel (required). Returns: result
connect_mixerB
Connect to the XR18 mixer at the given IP and port (default 10024).
Inputs: ip (required), port. Returns: result
get_channel_faderC
Query the current fader level of an input channel.
Inputs: channel (required). Returns: result
get_channel_send_to_busB
Query the current send level from a channel to a bus.
Inputs: bus (required), channel (required). Returns: result
get_mixer_infoB
Query mixer info via /xinfo.
Inputs: no named parameters. Returns: result
list_namesA
Show all current channel and bus name assignments.
Inputs: no named parameters. Returns: object
send_raw_oscC
Send a raw OSC message. Escape hatch for any OSC command.
Inputs: address (required), args. Returns: result
set_bus_faderB
Set a bus master fader level in dB. Bus can be a number (1-6) or name.
Inputs: bus (required), level_db (required). Returns: result
set_bus_muteA
Mute or unmute a bus. Bus can be a number (1-6) or name.
Inputs: bus (required), muted (required). Returns: result
set_channel_eqB
Set EQ parameters for a channel band (1-4).
Inputs: q (required), band (required), channel (required), gain_db (required), +1 more. Returns: result
set_channel_eq_onB
Enable or disable EQ on a channel.
Inputs: channel (required), enabled (required). Returns: result
set_channel_faderB
Set an input channel's fader level in dB. Channel can be a number (1-18) or name.
Inputs: channel (required), level_db (required). Returns: result
set_channel_muteA
Mute or unmute an input channel. Channel can be a number (1-18) or name.
Inputs: muted (required), channel (required). Returns: result
set_channel_send_to_busC
Set how much of a channel goes to a specific bus/monitor in dB.
Inputs: bus (required), channel (required), level_db (required). Returns: result
set_fx_send_faderB
Set an FX send fader level in dB (slot 1-4).
Inputs: fx_slot (required), level_db (required). Returns: result
set_fx_send_muteA
Mute or unmute an FX send (slot 1-4).
Inputs: muted (required), fx_slot (required). Returns: result
set_main_faderB
Set the main LR output fader level in dB.
Inputs: level_db (required). Returns: result
set_main_muteB
Mute or unmute the main LR output.
Inputs: muted (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a distinct operation (e.g., fader, mute, EQ, send) on a specific resource (channel, bus, main, FX). Even similar tools like set_channel_fader and set_channel_mute are clearly differentiated by their purpose.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., assign_channel_name, set_channel_fader, get_channel_send_to_bus). There is no mixing of conventions or ambiguous verbs.
With 19 tools covering channel, bus, main, FX, naming, info, and a raw OSC escape, the count is well-scoped for a mixer control server. It includes all essential operations without being bloated.
The tool set covers core mixer operations (fader, mute, EQ, sends, main). Missing features like compressor or gate are offset by the send_raw_osc escape hatch, preventing dead ends.
Maintenance
Related MCP Connectors
OSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for Producer/Riffusion AI music generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for the Behringer DeepMind 12 synthesizer. Gives AI agents real-time control over synth parameters via MIDI NRPN, plus edit-buffer snapshots via SysEx.28 npm3MIT
- AlicenseAqualityDmaintenanceEnables control of Behringer X32/M32 digital mixing consoles via OSC protocol for remote mixing, automated setup, and live adjustments through an AI assistant.2424 npmMIT
- AlicenseAqualityCmaintenanceEnables controlling Behringer WING digital mixers via OSC, supporting fader, mute, pan, and name operations on strips, with raw OSC access for unsupported parameters.118MIT
- AlicenseBqualityDmaintenanceAn MCP server for controlling Voicemeeter (Basic, Banana, or Potato) on Windows: strip and bus gains, mutes, output routing, live levels, macro buttons, presets, and audio-engine restarts.17MIT