
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


