dcc-mcp-obs

DCC-MCP 생태계를 위한 네이티브, 타입화된 OBS Studio 제어.

이 제품은 OBS 플러그인과 DCC-MCP 사이드카로 구성됩니다. C++ 플러그인은 정확한 OBS 프로세스 내부에서 실행되며, 호스트 수명 주기와 UI 스레드 디스패치를 소유하고, 공식 OBS WebSocket 5.x API를 통해 제한된 벤더 요청을 등록합니다. Python 사이드카는 MCP, Gateway, Install SOP v1 CLI 및 번들된 Agent 스킬을 통해 이러한 계약을 노출합니다.

OBS WebSocket은 인증된 전송 수단입니다. 무제한 요청 탈출구로 사용되지 않으며, 이 제품은 임의 스크립트나 원시 WebSocket 도구를 노출하지 않습니다.

첫 번째 슬라이스

• 정확한 네이티브 플러그인, OBS 버전, PID, 인스턴스 ID, 준비 상태 및 이벤트 시퀀스

• 제한된 장면 검색 및 현재 장면 읽기

• 현재 또는 정확한 이름의 장면에 대한 제한된 소스 검색

• 녹화 상태

• 녹화 시작, 중지, 일시정지 및 재개

• 모든 변경 후 별도의 타입화된 상태 읽기

• 안정적인 마스킹 오류, 제한된 UI 디스패치 및 정확한 인스턴스 드리프트 거부

기계 판독 가능한 기능 매트릭스는 나머지 제품 도메인을 추적합니다. 타입화된 계약이 도입될 때까지 의도적으로 출시된 도구로 표시되지 않습니다.

Related MCP server: obs-mcp-server

전체 제어 로드맵

• 스트리밍, 리플레이 버퍼, 가상 카메라 및 출력

• 프로필, 장면 컬렉션, 제한된 단축키, 스크린샷 및 운영자 상태

• 일회용 실제 OBS 승인

• 입력, 속성, 필터, 오디오 및 미디어

• 장면 그래프, 전환, 트랜지션 및 스튜디오 모드

요구 사항

• OBS WebSocket 5.x가 활성화된 OBS Studio 28 이상

• Python 3.10 이상

• dcc-mcp-core>=0.20.14,<1.0.0

• Windows, macOS 또는 Linux용 일치하는 네이티브 플러그인 패키지

설치

Python 제어 평면을 설치한 다음, 동일한 릴리스에서 얻은 SHA-256 다이제스트가 있는 릴리스 네이티브 플러그인 번들을 설치합니다:

python -m pip install dcc-mcp-obs
dcc-mcp-obs-install install \
  --plugin-archive dcc-mcp-obs-plugin.zip \
  --sha256 <release-sha256>
dcc-mcp-obs-install verify

설치 프로그램은 하나의 Install SOP v1 JSON 객체를 출력합니다. --dry-run은 OBS 플러그인 디렉터리를 변경하지 않고 번들 및 소유권 사전 점검을 수행합니다. 설치 세부 정보를 참조하세요.

비밀번호 및 엔드포인트

운영자 소유 환경에서 OBS WebSocket 비밀번호를 구성합니다:

set DCC_MCP_OBS_WEBSOCKET_PASSWORD=your-password

첫 번째 릴리스는 ws://127.0.0.1:<port>만 허용하며 기본 포트는 4455. 비밀번호는 도구 결과, 영수증, 공개 오류 또는 로그에 절대 반환되지 않습니다. DCC_MCP_OBS_WEBSOCKET_URL은 다른 루프백 포트를 선택할 때만 사용하세요.

하나의 정확한 OBS 프로세스에 대해 사이드카를 실행합니다:

dcc-mcp-obs --host-pid <obs-pid>

에이전트 검색

번들된 obs-control 스킬에는 OBS, Open Broadcaster Software, 녹화, 장면/소스 검사, 일시정지, 재개, 录屏 및 录制视频에 대한 영어 및 중국어 검색 별칭이 포함됩니다. 에이전트는 이 첫 번째 슬라이스의 정확한 여덟 가지 도구를 호출하기 전에 스킬을 검색하고 로드합니다. 스트리밍 및 장면 전환은 출시된 네이티브 제어가 아닌 로드맵 기능으로 남아 있습니다.

OBS 제어는 네이티브 플러그인/WebSocket 우선입니다. 지원되지 않는 시각 전용 작업은 정확한 PID 및 HWND 바인딩, 새 스냅샷, 작업 후 읽기 이후에만 프로젝트 소유 DCC-CUA와 함께 DCC-MCP ui-control을 사용할 수 있습니다. 일반적인 Computer Use 폴백은 없습니다.

개발

python -m pip install -e ".[dev]"
python -m pytest
python -m ruff check .
python -m ruff format --check .
dcc-mcp-cli lint src/dcc_mcp_obs/skills/obs-control --warnings-as-errors

네이티브 빌드는 공식 OBS 플러그인 템플릿 툴체인과 SHA-256 해시로 고정된 OBS 31.1.1 SDK 입력을 사용합니다:

cmake --preset windows-x64
cmake --build --preset windows-ci-x64

동등한 CI 빌드가 Windows, macOS 및 Linux에서 실행됩니다.

검증 경계

단위 테스트, 모의 프로토콜 세션, 네이티브 컴파일, 패키지 스모크 테스트 및 CI는 라이선스/라이브 OBS 호스트를 입증하지 않습니다. 이 초기 제공물은 실제 OBS 승인을 주장하지 않습니다. 일회용 라이브 호스트 승인 이슈는 별도의 릴리스 게이트로 남아 있습니다.

라이선스

GPL-2.0-or-later. 네이티브 모듈은 OBS Studio에 링크되며 공식 OBS WebSocket 플러그인 API 헤더를 원본 고지와 함께 번들로 제공합니다.