OBS MCP Server

by royshil
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Utilizes Node.js as the runtime environment for the MCP server, with Node.js 16+ being a requirement for operation.

  • Connects to OBS Studio via the WebSocket protocol, providing tools for scene management, source control, streaming/recording control, transitions, and general operations in OBS.

OBS MCP 서버

OBS WebSocket 프로토콜을 통해 OBS를 제어하는 도구를 제공하는 OBS Studio용 MCP 서버입니다.

특징

  • OBS WebSocket 서버에 연결
  • MCP 도구를 통한 OBS 제어
  • 다음을 위한 도구를 제공합니다.
    • 일반 운영
    • 장면 관리
    • 소스 제어
    • 장면 항목 조작
    • 스트리밍 및 녹화
    • 전환

설치

지엑스피1

용법

  1. OBS Studio가 WebSocket 서버가 활성화된 상태로 실행되고 있는지 확인하세요(도구 > WebSocket 서버 설정). WS 비밀번호를 적어 두세요.
  2. 환경 변수에 WebSocket 비밀번호를 설정합니다(필요한 경우):
export OBS_WEBSOCKET_PASSWORD="your_password_here"
  1. OBS MCP 서버를 실행하여 빌드하고 연결할 수 있는지 확인하세요.
npm run build npm run start
  1. MCP 서버 설정을 사용하여 Claude 데스크톱을 제공합니다.
{ "mcpServers": { "obs": { "command": "node", "args": [ "<obs-mcp_root>/build/index.js" ], "env": { "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>" } } } }
  1. Claude를 사용하여 OBS를 제어하세요!

사용 가능한 도구

서버는 다음과 같은 범주별로 정리된 도구를 제공합니다.

  • 일반 도구: 버전 정보, 통계, 단축키, 스튜디오 모드
  • 장면 도구: 장면 나열, 장면 전환, 장면 생성/제거
  • 소스 도구: 소스, 설정, 오디오 레벨, 음소거/음소거 해제 관리
  • 장면 항목 도구: 장면의 항목을 관리합니다(위치, 가시성 등)
  • 스트리밍 도구: 스트리밍 시작/중지, 녹화, 가상 카메라
  • 전환 도구: 전환, 지속 시간 설정, 전환 트리거

환경 변수

  • OBS_WEBSOCKET_URL : 웹소켓 URL(기본값: ws://localhost:4455)
  • OBS_WEBSOCKET_PASSWORD : OBS WebSocket 인증을 위한 비밀번호(필요한 경우)

요구 사항

  • 노드.js 16+
  • WebSocket 서버가 활성화된 OBS Studio 31+
  • 클로드 데스크탑

특허

자세한 내용은 LICENSE 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

OBS WebSocket 프로토콜을 통해 OBS Studio를 원격으로 제어할 수 있는 도구를 제공하는 서버로, MCP 클라이언트 인터페이스를 통해 장면, 소스, 스트리밍 및 녹화를 관리할 수 있습니다.

  1. Features
    1. Installation
      1. Usage
        1. Available Tools
          1. Environment Variables
            1. Requirements
              1. License
                ID: ss2j6yvx7q