OBS MCP 服务器

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

功能特性

• 连接到 OBS WebSocket 服务器
• 通过 MCP 工具控制 OBS
• 提供以下工具：
  • 常规操作
  • 场景管理
  • 来源控制
  • 场景项目操作
  • 推流和录制
  • 转场

安装

npm install
npm run build

使用方法

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

export OBS_WEBSOCKET_PASSWORD="your_password_here"

3. 运行 OBS MCP 服务器，以确保它可以构建和连接：

npm run build
npm run start

4. 使用 MCP 服务器设置配置您的 Claude 桌面：

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

5. 使用 Claude 控制您的 OBS！

可用工具

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

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

环境变量

• OBS_WEBSOCKET_URL: WebSocket URL (默认: ws://localhost:4455)
• OBS_WEBSOCKET_PASSWORD: 用于 OBS WebSocket 身份验证的密码（如果需要）

要求

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

许可证

有关详细信息，请参见 LICENSE 文件。