dcc-mcp-obs

Native, typisierte OBS-Studio-Steuerung für das DCC-MCP-Ökosystem.

Dieses Produkt ist ein OBS-Plugin plus ein DCC-MCP-Sidecar. Das C++-Plugin läuft im exakten OBS-Prozess, verwaltet den Host-Lebenszyklus und die UI-Thread-Verteilung und registriert begrenzte Anbieteranfragen über die offizielle OBS-WebSocket-5.x-API. Das Python-Sidecar stellt diese Verträge über MCP, das Gateway, eine Install-SOP-v1-CLI und eine gebündelte Agent-Fähigkeit bereit.

OBS WebSocket ist der authentifizierte Transport. Es wird nicht als uneingeschränkter Anfrage-Ausweg verwendet, und dieses Produkt stellt keine beliebigen Skript- oder Roh-WebSocket-Werkzeuge bereit.

Erster Teil

• Exaktes natives Plugin, OBS-Version, PID, Instanz-ID, Bereitschaft und Ereignissequenz

• Begrenzte Szenenermittlung und Rücklesen der aktuellen Szene

• Begrenzte Quellenermittlung für die aktuelle oder eine exakt benannte Szene

• Aufnahmestatus

• Aufnahme starten, stoppen, pausieren und fortsetzen

• Ein separates typisiertes Status-Rücklesen nach jeder Änderung

• Stabile geschwärzte Fehler, begrenzte UI-Verteilung und Ablehnung von Abweichungen der exakten Instanz

Die maschinenlesbare Fähigkeitsmatrix verfolgt die verbleibenden Produktdomänen. Sie werden absichtlich nicht als ausgelieferte Werkzeuge dargestellt, bis ihre typisierten Verträge vorliegen.

Related MCP server: obs-mcp-server

Roadmap zur vollständigen Steuerung

• Streaming, Replay-Puffer, virtuelle Kamera und Ausgaben

• Profile, Szenensammlungen, begrenzte Hotkeys, Screenshots und Operator-Status

• Wegwerfbare echte OBS-Abnahme

• Eingaben, Eigenschaften, Filter, Audio und Medien

• Szenengraph, Umschalten, Übergänge und Studio-Modus

Anforderungen

• OBS Studio 28 oder neuer mit aktiviertem OBS WebSocket 5.x

• Python 3.10 oder neuer

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

• Das passende native Plugin-Paket für Windows, macOS oder Linux

Installation

Installieren Sie die Python-Steuerungsebene und dann ein release-natives Plugin-Bündel, dessen SHA-256-Prüfsumme Sie aus demselben Release erhalten haben:

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

Der Installer gibt ein Install-SOP-v1-JSON-Objekt aus. --dry-run führt eine Vorabprüfung von Bündel und Eigentum durch, ohne das OBS-Plugin-Verzeichnis zu ändern. Siehe Installationsdetails.

Passwort und Endpunkt

Konfigurieren Sie das OBS-WebSocket-Passwort in der vom Betreiber verwalteten Umgebung:

set DCC_MCP_OBS_WEBSOCKET_PASSWORD=your-password

Das erste Release akzeptiert nur ws://127.0.0.1:<port> und verwendet standardmäßig Port 4455. Ein Passwort wird niemals in Tool-Ergebnissen, Belegen, öffentlichen Fehlern oder Protokollen zurückgegeben. Verwenden Sie DCC_MCP_OBS_WEBSOCKET_URL nur, um einen anderen Loopback-Port auszuwählen.

Führen Sie das Sidecar gegen einen exakten OBS-Prozess aus:

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

Agent-Erkennung

Die gebündelte obs-control-Fähigkeit enthält englische und chinesische Erkennungsaliase für OBS, Open Broadcaster Software, Aufnahme, Szenen-/Quelleninspektion, Pause, Fortsetzen, 录屏 und 录制视频. Agenten suchen und laden die Fähigkeit, bevor sie die exakt acht Werkzeuge in diesem ersten Teil aufrufen. Streaming und Szenenumschaltung bleiben Roadmap-Fähigkeiten, keine ausgelieferten nativen Steuerungen.

OBS-Steuerung ist zuerst nativ-Plugin/WebSocket. Nicht unterstützte rein visuelle Aktionen dürfen DCC-MCP ui-control mit projekteigenem DCC-CUA nur nach exakter PID- und HWND-Bindung, einer frischen Momentaufnahme und Rücklesen nach der Aktion verwenden. Es gibt keinen generischen Computer-Use-Fallback.

Entwicklung

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

Der native Build verwendet die offizielle OBS-Plugin-Vorlagen-Toolchain und OBS-31.1.1-SDK-Eingaben, die mit SHA-256-Hashes festgelegt sind:

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

Äquivalente CI-Builds laufen auf Windows, macOS und Linux.

Validierungsgrenze

Unit-Tests, Fake-Protokollsitzungen, native Kompilierung, Paket-Smoke-Tests und CI beweisen keinen lizenzierten/live OBS-Host. Diese erste Lieferung erhebt keinen Anspruch auf echte OBS-Abnahme. Ein Problem mit der Abnahme eines wegwerfbaren Live-Hosts bleibt ein separates Release-Gate.

Lizenz

GPL-2.0-or-later. Das native Modul verlinkt mit OBS Studio und liefert den offiziellen OBS-WebSocket-Plugin-API-Header mit seinem ursprünglichen Hinweis.