# osc-bridge

> osc-bridge is an open-source MCP server for design and media. Open-source bridge that gives synths and DAWs named OSC controls, plus a driver catalogue. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux, Web, API
- **Website:** https://synthhub.roomi-fields.com
- **Repository:** https://github.com/roomi-fields/osc-bridge
- **MCP Registry name:** io.github.roomi-fields/osc-bridge
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Hardware synths speak MIDI and SysEx with cryptic CC and NRPN numbers, while DAWs and live-coding tools speak OSC. osc-bridge describes each device in one JSON driver file and exposes it as a readable OSC surface, so a message like /minilab3/pad/0/color sets a pad colour. Adding a device does not need a recompile.

The driver catalogue lives on SynthHub, which the maintainer says knows the MIDI implementation of 973 devices and hosts about 55,000 community sounds. osc-bridge fetches one driver at a time and caches it locally, and an offline mode uses only cached drivers and sends nothing. The README lists targets such as Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data, TouchDesigner and VCV Rack.

There are two MCP routes: a hosted SynthHub server with the catalogue and a relay to your own hardware, or a local stdio server started with npx that adds hardware detection. The bridge is AGPL-3.0 licensed and also runs as a standalone CLI.

## Features

- **Named OSC surface:** Each device gets readable OSC addresses defined by a single JSON driver file.
- **MIDI and OSC together:** Bridges hardware over MIDI and SysEx with DAWs and live-coding tools over OSC.
- **SynthHub driver catalogue:** Fetches one driver at a time from a catalogue covering 973 devices.
- **Hardware detection:** Identifies connected MIDI hardware and names matching drivers and firmware.
- **Offline mode:** Uses only cached drivers and sends nothing when offline mode is on.
- **Hosted or local MCP:** Use the hosted server over HTTP or run a local stdio server with npx.

## Good for

- Ask an assistant to set the filter on a connected minilogue
- Drive a hardware synth from SuperCollider or Sonic Pi over OSC
- Find a sound for a Yamaha DX7 or Roland D-50 in the SynthHub catalogue
- Script MIDI hardware without hand-rolling SysEx bytes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http osc-bridge https://mcp.synthhub.roomi-fields.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.synthhub.roomi-fields.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "osc-bridge": {
      "url": "https://mcp.synthhub.roomi-fields.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "osc-bridge": {
      "type": "http",
      "url": "https://mcp.synthhub.roomi-fields.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "osc-bridge": {
      "serverUrl": "https://mcp.synthhub.roomi-fields.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "osc-bridge": {
      "type": "http",
      "url": "https://mcp.synthhub.roomi-fields.com/mcp"
    }
  }
}
```

## Tools

- `detect_hardware`: Detects connected MIDI hardware and names the matching drivers and firmware.
- `list_devices`: Searches the SynthHub device catalogue.

## FAQ

### How do I run the local MCP server?

Run npx -y @roomi-fields/osc-bridge mcp. It adds hardware detection and OSC to a running bridge.

### Is there a hosted option?

Yes. The SynthHub server at https://mcp.synthhub.roomi-fields.com/mcp needs nothing installed and can be added to Claude, Cursor and other clients.

### What licence is it under?

The site lists osc-bridge as open source under AGPL-3.0.

### Does it work without internet?

Yes, in offline mode, using only the drivers already in its cache.

### Which software does it support?

The README names Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data, TouchDesigner and VCV Rack.

### Is osc-bridge free?

Yes. osc-bridge is open source, so you can use and self-host it for free.

### How do I add osc-bridge to Claude Code?

Run this command in your terminal: claude mcp add --transport http osc-bridge https://mcp.synthhub.roomi-fields.com/mcp

### What are the best alternatives to osc-bridge?

The closest alternatives to osc-bridge are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/osc-bridge
