mcpField
O
OSCAR

OSCAR

本地服务
createwithoscar.site媒体与设计1922 周前更新

关于 OSCAR

OSCAR 是一款免费开源的控制界面编辑器与服务器,createwithoscar 可将 AI 助手连接到本机运行的 OSCAR。助手可以读取项目、控件设置与 MIDI 端口等信息,协助排查问题或起草界面供用户审核。它不会向设备发送任何内容,也不会修改或发布项目。

主要功能

  1. 01读取本机 OSCAR 的项目、控件设置与 MIDI 端口
  2. 02查看 OSCAR 近期收发的 OSC、MIDI 与 DMX 数据
  3. 03起草界面并交由 OSCAR 的验证器检查
  4. 04草稿以 Draft 标记出现,由用户自行打开与发布
  5. 05请求仅发送至本机 OSCAR,不经过其他地方

适用场景

  1. 01排查滑块或按钮未能控制灯光或软件的原因
  2. 02根据自然语言描述生成灯光或音频控制界面
  3. 03为调光台快速搭建包含推子与总控按钮的页面

MCP 相关

该项目是一个 MCP 服务,向 MCP 客户端(如 Claude Desktop、Cursor)暴露 OSCAR 的读取与草稿编写工具,并通过本机地址与令牌与 OSCAR 通信。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"trafalmejo-oscar": {
"command": "npx",
"args": [
"-y",
"createwithoscar"
]
}
}
}
启动命令npx -y createwithoscar

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmcreatewithoscar1.0.2

工具

11

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

createwithoscar

将 AI 助手连接到 OSCAR。OSCAR 是一款免费的开源控制界面编辑器和服务:控制界面由按钮、滑块和其他控件组成,可在手机和平板电脑上打开,并向演出软件、乐器和灯光发送 OSC、MIDI 和 DMX。

借助它,Claude 这样的助手可以:

  • 查明设备为何没有响应。 它会读取你电脑上运行的 OSCAR:其中的项目、已发布的内容、每个小组件的设置、MIDI 端口,以及 OSCAR 最近接收和发送的内容。
  • 为你起草一个界面。 它会编写界面,并由 OSCAR 自带的验证器进行检查。随后,界面会出现在 OSCAR 的 File > Open project or template 下,并带有 Draft 徽标,供你自行打开、检查和发布。

它绝不会向你的设备发送任何内容、发布界面或更改项目。

连接

必须在同一台电脑上运行 OSCAR 2.1 或更高版本,并确保顶栏中的 MCP 状态标记为绿色。

Claude Code

claude mcp add oscar -- npx -y createwithoscar

Claude Desktop:从 createwithoscar.site 下载 OSCAR.mcpb 并双击即可。无需安装其他内容。

Cursor、VS Code、Windsurf、Codex、Gemini CLI 和其他 MCP 应用:使用命令 npx 和参数 -y createwithoscar 添加服务。在大多数应用中,配置如下:

{
  "mcpServers": {
    "oscar": { "command": "npx", "args": ["-y", "createwithoscar"] }
  }
}

如果在 Windows 上无法启动,请使用命令 cmd 和参数 /c npx -y createwithoscar。

然后可以这样提问:

  • “帮我制作一个 OSCAR 界面,包含四个推子和一个用于灯光控制台的全黑按钮。”
  • “我的 OSCAR 滑块没法控制灯光。你能帮我看看原因吗?”

工作原理

这是一个没有依赖项的小程序。助手会启动它,并通过 MCP 与它通信;它会将每个请求转发给这台电脑上的 OSCAR,不会发送到其他地方。它通过 OSCAR 启动时写入的文件(~/.oscar/mcp.json)查找 OSCAR。该文件包含 OSCAR 的本地地址和一个每次启动时都会变化的令牌。在 OSCAR 中关闭 MCP 状态标记即可关闭连接。

如果 OSCAR 没有运行,助手仍会看到这些工具,并会被告知请你启动 OSCAR。

需要 Node 18 或更高版本(Claude Desktop 版本使用 Claude 自带的 Node)。

许可协议

BSD-3-Clause,与 OSCAR 相同。源代码: github.com/trafalmejo/OSCAR。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。