OBS MCP Server

这是一个用于OBS Studio的MCP服务器，提供通过OBS WebSocket协议控制OBS的工具。

功能

• 连接到OBS WebSocket服务器
• 使用MCP工具控制OBS
• 提供以下工具：
  • 常规操作
  • 场景管理
  • 源控制
  • 场景项操作
  • 直播与录制
  • 转场

使用方法

1. 确保OBS Studio正在运行，并且启用了WebSocket服务器（工具 > WebSocket服务器设置）。注意WS的密码。
2. 设置环境变量中的WebSocket密码（如果需要）：

export OBS_WEBSOCKET_PASSWORD="your_password_here"

3. 将MCP服务器添加到Claude桌面中，使用MCP服务器设置：

{
  "mcpServers": {
    "obs": {
      "command": "npx",
      "args": ["-y", "obs-mcp@latest"],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

4. 使用Claude来控制你的OBS！

开发

如果你想使用这个git仓库中的代码本地运行服务器，可以执行以下步骤：

npm run build
npm run start

然后配置Claude桌面：

{
  "mcpServers": {
    "obs": {
      "command": "node",
      "args": [
        "<obs-mcp_root>/build/index.js"
      ],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

可用工具

服务器提供的工具按类别组织如下：

• 常规工具：版本信息、统计、快捷键、工作室模式
• 场景工具：列出场景、切换场景、创建/删除场景
• 源工具：管理源、设置、音频电平、静音/取消静音
• 场景项工具：管理场景中的项目（位置、可见性等）
• 直播工具：开始/停止直播、录制、虚拟摄像头
• 转场工具：设置转场、持续时间、触发转场

环境变量

• OBS_WEBSOCKET_URL：WebSocket URL（默认：ws://localhost:4455）
• OBS_WEBSOCKET_PASSWORD：用于与OBS WebSocket认证的密码（如需）

要求

• Node.js 16+
• OBS Studio 31+ 并启用WebSocket服务器
• Claude桌面

许可证

详情见LICENSE文件。