Skip to main content
Glama
Sign In
deenesjakoruzh
dcc-mcp

dcc-mcp-obs

by dcc-mcp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Roadmap zur vollständigen Steuerung

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • OBS MCP

    KshamayBharadwaj
    A
    license
    B
    quality
    B
    maintenance
    Enables AI assistants to control and automate OBS Studio via natural language, covering scenes, sources, audio, recording, streaming, transitions, filters, media playback, diagnostics, and multi-step workflows over the OBS WebSocket protocol.
    89
    MIT

  • OBS MCP

    Tom-R-Main
    A
    license
    B
    quality
    B
    maintenance
    Enables MCP clients to control OBS Studio through an inspectable WebSocket interface. Provides 155 tools for managing scenes, sources, audio, transitions, filters, recording, and streaming through natural language.
    155
    558 npm
    3
    GPL 2.0

  • obs-control-mcp

    rjla-developer
    A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to inspect and safely control OBS Studio over obs-websocket v5, exposing scenes, inputs, filters, outputs and video settings as read and write tools that default to dry runs and refuse changes while live unless explicitly confirmed. It also provides Source Record and IRL readiness checks, a BRB auto-switcher, and a scene timeline log for cutting clips from VODs.
    17
    MIT