OBS MCP 서버
OBS WebSocket 프로토콜을 통해 OBS를 제어하는 도구를 제공하는 OBS Studio용 MCP 서버입니다.
특징
- OBS WebSocket 서버에 연결
- MCP 도구를 통한 OBS 제어
- 다음을 위한 도구를 제공합니다.
- 일반 운영
- 장면 관리
- 소스 제어
- 장면 항목 조작
- 스트리밍 및 녹화
- 전환
설치
지엑스피1
용법
- OBS Studio가 WebSocket 서버가 활성화된 상태로 실행되고 있는지 확인하세요(도구 > 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 : 웹소켓 URL(기본값: ws://localhost:4455)OBS_WEBSOCKET_PASSWORD : OBS WebSocket 인증을 위한 비밀번호(필요한 경우)
요구 사항
- 노드.js 16+
- WebSocket 서버가 활성화된 OBS Studio 31+
- 클로드 데스크탑
특허
자세한 내용은 LICENSE 파일을 참조하세요.