# osc-bridge

An MCP server that lets an agent talk to music gear: it sends OSC, the bridge turns that into MIDI and SysEx. Handy when you want a synth or DAW under chat control.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: roomi-fields
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/roomi-fields/osc-bridge
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/osc-bridge

## What it does

Every supported device is one JSON file — CC numbers, SysEx frame templates, optional parameter tables. Adding a synth takes roughly 30 lines of declarative JSON, with no recompile. The catalogue covers 988 devices from 215 vendors, including Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data, TouchDesigner and VCV Rack.

The built-in MCP server hands the whole catalogue to the agent: it looks up devices, reads a model's OSC surface, and sends messages. Incoming MIDI — knob turns, SysEx replies, NRPN — gets decoded back into OSC. A single process can drive several synths at once, each under its own prefix such as `/matrixbrute-1` and `/matrixbrute-2`.

Devices with checksums or odd scaling can use Lua 5.4 in a sandbox: 1 MiB and 10 ms caps, no `os`, `io` or loaders. `osc-bridge lint` flags every script. Running locally goes through `npx -y @roomi-fields/osc-bridge mcp`; the standalone bridge needs Node.js and `npm install -g @roomi-fields/osc-bridge`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.synthhub.roomi-fields.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http osc-bridge https://mcp.synthhub.roomi-fields.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add osc-bridge -- npx -y @roomi-fields/osc-bridge
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add osc-bridge --url https://mcp.synthhub.roomi-fields.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add osc-bridge -- npx -y @roomi-fields/osc-bridge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "osc-bridge": {
            "url": "https://mcp.synthhub.roomi-fields.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "osc-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "@roomi-fields/osc-bridge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "osc-bridge": {
            "type": "http",
            "url": "https://mcp.synthhub.roomi-fields.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "osc-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@roomi-fields/osc-bridge"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http osc-bridge https://mcp.synthhub.roomi-fields.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add osc-bridge npx -y @roomi-fields/osc-bridge
```

## When to use it
- control a hardware synth from an agent chat
- look up OSC addresses for a specific synth model
- wire Ableton or Bitwig into an OSC client
- keep two identical synths on separate prefixes
- add support for new gear without rebuilding the binary

## Example prompts
- Find the Arturia MiniLab 3 in the catalogue and show its OSC surface
- Send 127, 0, 0 to `/minilab3/pad/0/color`
- Orchestrate two MatrixBrutes from `bridge.toml`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md