O
OBS远程控制面板
@royshil/obs-mcp
1 Stars
1.2k 次浏览
royshil
更新于 2026-08-23
一台通过OBS WebSocket协议提供远程控制OBS Studio工具的服务器，可以通过MCP客户端界面管理场景、源、流媒体和录制。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"obs": {
"args": [
"\u003cobs-mcp_root\u003e/build/index.js"
],
"command": "node",
"env": {
"OBS_WEBSOCKET_PASSWORD": "\u003cpassword_from_obs\u003e"
}
}
}
}该服务需要配置环境变量：OBS_WEBSOCKET_PASSWORD、OBS_WEBSOCKET_URL
服务介绍
OBS MCP 服务器
一个用于OBS Studio的MCP服务器，提供通过OBS WebSocket协议控制OBS的工具。
功能
- 连接到OBS WebSocket服务器
- 通过MCP工具控制OBS
- 提供以下功能的工具：
- 常规操作
- 场景管理
- 源控制
- 场景项操作
- 流媒体和录制
- 转场效果
安装
npm install
npm run build
使用方法
- 确保开启了WebSocket服务器的OBS Studio正在运行（工具 > WebSocket服务器设置）。记下WS的密码。
- 如果需要的话，在环境变量中设置WebSocket密码：
export OBS_WEBSOCKET_PASSWORD="your_password_here"
- 运行OBS MCP服务器以检查它是否能够构建并连接成功：
npm run build
npm run start
- 使用MCP服务器设置配置你的Claude桌面：
{
"mcpServers": {
"obs": {
"command": "node",
"args": [
"<obs-mcp_root>/build/index.js"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
}
}
}
}
- 使用Claude来控制你的OBS！
可用工具
该服务器按类别组织提供了如下工具：
- 通用工具：版本信息、统计信息、快捷键、工作室模式
- 场景工具：列出场景、切换场景、创建/删除场景
- 源工具：管理源、设置、音频级别、静音/取消静音
- 场景项工具：管理场景中的项（位置、可见性等）
- 流媒体工具：开始/停止流媒体、录制、虚拟摄像头
- 转场工具：设置转场、持续时间、触发转场
环境变量
OBS_WEBSOCKET_URL：WebSocket URL（默认值: ws://localhost:4455）OBS_WEBSOCKET_PASSWORD：与OBS WebSocket认证所需的密码（如果需要）
要求
- Node.js 16+
- 启用了WebSocket服务器的OBS Studio 31+
- Claude桌面
许可证
详情请参见LICENSE文件。
