# OSCAR

Connects your OSCAR installation to an AI assistant: it reads projects, widgets, ports, and drafts control interfaces. Never publishes or changes anything itself.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 196 repo stars
- Author: trafalmejo
- License: BSD-3-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trafalmejo/OSCAR/tree/HEAD/createwithoscar
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/oscar

## What it does

The server gives an AI assistant access to your OSCAR installation — the editor for OSC, MIDI and DMX control interfaces. The assistant sees all projects, every widget's configuration, MIDI port list, and message history. It can sketch an interface: that draft shows up in OSCAR with a Draft badge, and you decide whether to open and publish it.

The server never sends anything to your rig, never publishes, and never edits existing projects. Needs OSCAR version 2.1 or newer running locally, with the MCP toggle in the top bar green. On Windows you may need Node 18 or later.

It reaches OSCAR through a file OSCAR writes at startup (`~/.oscar/mcp.json`): that file holds the address and a token that refreshes every time. Switch the MCP toggle off in OSCAR and the server loses access.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add oscar -- npx -y createwithoscar
```

### Codex

**Platform CLI**
```bash
codex mcp add createwithoscar -- npx -y createwithoscar
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "createwithoscar": {
            "command": "npx",
            "args": [
                "-y",
                "createwithoscar"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "createwithoscar": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "createwithoscar"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add createwithoscar npx -y createwithoscar
```

## When to use it
- diagnose why a control does not respond to commands
- draft an interface with faders and buttons for a lighting desk
- inspect widget configuration and MIDI port settings
- see what messages OSCAR recently sent and received
- build a control panel for show software or instruments

## Example prompts
- Draft a four-fader interface with a blackout button for my lighting console
- Why isn't this fader controlling the fixture?
- Show me all widget settings in the current OSCAR project

## Similar
- [osc-bridge](https://affpapa.org/en/nevibecode/mcp/osc-bridge.md) — MCP server · ★ 12 repo stars
- [ableton-live-mcp-control](https://affpapa.org/en/nevibecode/skills/ableton-live-mcp-control.md) — skill · 237 installs
- [SuperCollider](https://affpapa.org/en/nevibecode/mcp/supercollider.md) — MCP server · ★ 28 repo stars
- [Ableton Live MCP Server](https://affpapa.org/en/nevibecode/mcp/ableton-live-mcp-server.md) — MCP server · ★ 94 repo stars
- [PostFader](https://affpapa.org/en/nevibecode/mcp/postfader.md) — MCP server · ★ 16 repo stars
- [boostaudio](https://affpapa.org/en/nevibecode/mcp/boostaudio.md) — MCP server · 860 installs

---
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
