OSCAR logo

OSCAR

Inspect OSCAR installations and draft validated control interfaces without publishing or sending changes.

Install OSCAR

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "oscar": {
      "command": "npx",
      "args": [
        "-y",
        "createwithoscar"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

OSCAR MCP server connects an AI assistant to an OSCAR installation that manages OSC, MIDI, and DMX control surfaces. It exposes read-only views of projects, published interfaces, ports, activity, widget definitions, and the complete installation map. Agents can validate HTML interface drafts and save clean drafts for human review without publishing them or changing existing projects. Reach for OSCAR when you need to diagnose routing, understand a show-control setup, or prepare a phone and tablet interface.

Use cases

  • Inspect an OSCAR installation before a show
  • Diagnose missing OSC, MIDI, or DMX responses
  • Compare editable projects with published interfaces
  • Validate an HTML control-surface draft
  • Save a reviewed draft for a human to publish

Key features

  • Read project and published-interface state
  • Map OSC, MIDI, DMX, network, and USB routing
  • Inspect recent incoming and outgoing activity
  • Validate widget-based HTML drafts
  • Save clean drafts without publishing changes

Tools11

What OSCAR lets your agent do. Expand a tool for its parameters.

Verified live~1.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

15/15 checks healthy over the last 30d

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Makes network requests · 1Read-only tools · 11
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age22 days
Maintainers1

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · createwithoscar (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars195Stargazers on the source repository.
npm downloads213Package downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.

How OSCAR works

What OSCAR does

OSCAR MCP server gives an AI assistant an operational view of an OSCAR installation. OSCAR is a desktop and browser-based control-surface application for building interfaces with buttons, sliders, pads, and other widgets. Published interfaces can be opened on phones or tablets over a local network and can send OSC and MIDI messages, as well as control lighting through Art-Net, sACN, or a USB DMX interface.

The MCP tools cover both design-time projects and live published interfaces. They also expose the machine's network and MIDI environment, recent message activity, and the routing represented by the installation's settings. This makes the server useful for investigating why a control is not responding, checking what is currently published, or preparing an interface that a person can review in OSCAR.

How it works

The server reads OSCAR's project, interface, device, and activity state through MCP. status reports the application version, relevant ports, editing lock state, MIDI driver condition, and project counts. Project tools distinguish between editable projects and published copies: a project may have changed after its interface was published, so read_project and read_published can show different widget settings.

installation_map builds a configuration-level view of network addresses, ports, MIDI devices, USB interfaces, OSC destinations, MIDI channels and controllers, and DMX universes and channels. It reports configuration inconsistencies such as missing MIDI hardware, an OSC route without a listening port, or overlapping DMX channels. The map describes configured destinations; it does not test whether another device is listening.

Draft creation is deliberately separate from publication. An agent can inspect widget definitions, validate HTML against OSCAR's widget rules, and save a clean result as a named draft. The draft appears for a person to review, while existing projects, published interfaces, and external equipment remain unchanged.

Setup and configuration

OSCAR can be installed from the latest release for Windows, macOS, Linux, or 64-bit Raspberry Pi Linux. It can also be run from source with Node.js 18 or newer:

bash
git clone https://github.com/trafalmejo/OSCAR
cd OSCAR
npm install
npm start

The development server opens the local browser interface on port 8080 and prints a LAN address for use from a phone or tablet on the same network. A firewall must permit communication between those devices. npm run serve starts without rebuilding, while npm run dev rebuilds and restarts when files change.

Ports can be configured with OSCAR_HTTP_PORT, OSCAR_SOCKET_PORT, OSCAR_LAN_PORT, and OSCAR_LOCAL_PORT, or supplied through npm run serve:at. When only the HTTP port is supplied, related ports are derived unless matching environment variables are set. Conflicting or invalid port values stop startup rather than silently falling back.

Tools and capabilities

  • Inspect application status, ports, locks, MIDI health, and project counts.
  • List and read editable projects, including widget settings and publication details.
  • List published interfaces and read the settings currently visible to connected devices.
  • Map configured OSC, MIDI, DMX, network, and USB routing, including detected inconsistencies.
  • Review recent incoming and outgoing activity, grouped repeated events, destinations, origins, and dropped messages.
  • Read widget schemas, validate HTML drafts, and save clean drafts with optional overwrite behavior.

Limitations and notes

A saved draft is not a publication and does not send OSC, MIDI, or DMX traffic. Published interfaces may be older than their source projects, so troubleshooting should compare both representations. Activity describes what OSCAR received or sent, but an outgoing event does not prove that its destination device responded. The installation map likewise reports configured routing rather than network reachability.

Interfaces are intended for devices on the same network as OSCAR. The application supports Windows, macOS, Linux, and 64-bit Raspberry Pi Linux; source execution requires Node.js 18 or newer.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about OSCAR

OSCAR is an MCP server that connects an AI assistant to an OSCAR installation for OSC, MIDI, and DMX control surfaces. Its main tools inspect status, projects, published interfaces, routing, MIDI ports, activity, and widget definitions, and validate or save HTML interface drafts without publishing them or sending device commands.

Install OSCAR from its latest release for your platform, or run it from source with Node.js 18 or newer. From the repository, run `npm install` and `npm start`; OSCAR then opens its browser interface locally and prints a LAN address for devices on the same network.

Yes. Use `describe_widgets` to learn the HTML format, `validate_draft` to check it, and `create_draft` to save a clean result. The saved draft appears in OSCAR for human review and does not modify an existing project, publish an interface, or send traffic.

Start with `recent_activity`, then compare `read_project` with `read_published` and inspect `installation_map`. Activity shows what OSCAR received or sent, while the project and published views reveal differing widget settings; the map highlights configured routing inconsistencies but does not test whether a destination is listening.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOSCAR AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/oscar?style=directory)](https://allmcps.com/mcp/oscar)
HTML Embed
<a href="https://allmcps.com/mcp/oscar"><img src="https://allmcps.com/api/badge/oscar?style=directory" alt="OSCAR on AllMCPs" /></a>