
OSCAR
io.github.trafalmejov1.0.2更新于 Oct 5, 2026
An assistant reads your OSCAR installation (OSC, MIDI, DMX) and drafts interfaces you review.
概览
让助手检查本机 OSCAR 控制界面安装,并起草供你审核的 OSCAR 界面。
- 功能
- 将助手连接到 OSCAR——一个免费开源的控件界面编辑器与服务器,界面由按钮、滑块等控件组成,供手机和平板打开,并发送 OSC、MIDI 和 DMX。助手可以读取正在运行的安装:项目、已发布内容、每个控件的设置、MIDI 端口以及 OSCAR 最近的收发记录,从而帮助判断某个控件为何没有响应。它还能起草界面,由 OSCAR 自带的校验器检查,随后以“草稿”标记出现在“文件 > 打开项目或模板”中,供你自行打开、检查并发布。
- 适用场景
- 适合在为演出软件、乐器或灯光搭建或排查 OSCAR 控制界面时,让助手检查实时配置或生成初始布局。它面向本机桌面环境,需与正在运行的 OSCAR 配合使用。
- 运行要求
- 同一台电脑上需运行 OSCAR 2.1 或更高版本,且顶栏的 MCP 标记为绿色。该服务器通过 npx 以 stdio 在本地运行,需要 Node 18 或更高版本;Claude Desktop 捆绑包使用 Claude 自带的运行时。它通过文件 ~/.oscar/mcp.json 找到 OSCAR,其中保存 OSCAR 的本地地址和每次启动都会变化的令牌。未声明账号、API 密钥或环境变量。
安装
在 SourceWeft 中
- 打开 控制台中的 OSCAR,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
createwithoscar
Connects an AI assistant to OSCAR, the free, open-source editor and server for control interfaces: pages of buttons, sliders and other controls that phones and tablets open, and that send OSC, MIDI and DMX to show software, instruments and lights.
With it, an assistant such as Claude can:
- Find out why something does not respond. It reads the OSCAR running on your computer: its projects, what is published, every widget's settings, the MIDI ports, and what OSCAR lately received and sent.
- Draft an interface for you. It writes one, OSCAR's own validators check it, and it appears in OSCAR under File > Open project or template with a Draft badge, for you to open, check and publish yourself.
It never sends anything to your rig, publishes, or changes a project.
Connect
OSCAR 2.1 or later must be running on the same computer, with the MCP pill in its top bar green.
Claude Code
Claude Desktop: download OSCAR.mcpb from
createwithoscar.site and
double-click it. Nothing else to install.
Cursor, VS Code, Windsurf, Codex, Gemini CLI and other MCP apps: add a server with the command npx
and the arguments -y createwithoscar. In most apps that is:
If it does not start on Windows, use the command cmd with the arguments
/c npx -y createwithoscar.
Then ask, for example:
- "Build me an OSCAR interface with four faders and a blackout button for my lighting desk."
- "My OSCAR slider is not moving the light. Can you see why?"
How it works
This is a small program with no dependencies. The assistant starts it and
speaks MCP to it; it passes each request to OSCAR on this computer and
nowhere else. It finds OSCAR through a file OSCAR writes when it starts
(~/.oscar/mcp.json), which holds OSCAR's local address and a token that
changes at every start. Switching the MCP pill off in OSCAR closes the door.
If OSCAR is not running, the assistant still sees the tools, and is told to ask you to start OSCAR.
Needs Node 18 or later (the Claude Desktop bundle uses Claude's own).
Licence
BSD-3-Clause, as OSCAR is. Source: github.com/trafalmejo/OSCAR.
来源:createwithoscar/README.md,提交 5caee38
工具
0版本历史
1- v1.0.2最新Oct 5, 2026


