Skip to main content
Glama
Sign In
deenesjakoruzh
dcc-mcp

dcc-mcp-obs

by dcc-mcp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

dcc-mcp-obs

Нативное типизированное управление OBS Studio для экосистемы DCC-MCP.

Этот продукт представляет собой плагин OBS и сайдкар DCC-MCP. Плагин на C++ работает внутри того же процесса OBS, управляет жизненным циклом хоста и диспетчеризацией UI-потока, а также регистрирует ограниченные запросы вендора через официальный API OBS WebSocket 5.x. Сайдкар на Python предоставляет эти контракты через MCP, Gateway, CLI Install SOP v1 и встроенный навык Agent.

OBS WebSocket — это аутентифицированный транспорт. Он не используется как неограниченный обходной канал для запросов, и этот продукт не предоставляет произвольных скриптов или инструментов raw WebSocket.

Первый срез

  • Точный нативный плагин, версия OBS, PID, идентификатор экземпляра, готовность и последовательность событий

  • Ограниченное обнаружение сцен и чтение текущей сцены

  • Ограниченное обнаружение источников для текущей или точно указанной сцены

  • Статус записи

  • Запуск, остановка, пауза и возобновление записи

  • Отдельное типизированное чтение статуса после каждого изменения

  • Стабильные ошибки с удалением конфиденциальных данных, ограниченная диспетчеризация UI и отклонение дрейфа точного экземпляра

Машиночитаемая матрица возможностей отслеживает остальные домены продукта. Они намеренно не представлены в виде поставляемых инструментов, пока не появятся их типизированные контракты.

Related MCP server: OBS MCP

Дорожная карта полного управления

Требования

  • OBS Studio 28 или новее с включённым OBS WebSocket 5.x

  • 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

Установщик выводит один JSON-объект Install SOP v1. --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 только для выбора другого порта loopback.

Запустите сайдкар для одного конкретного процесса OBS:

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

Обнаружение агентом

Встроенный навык obs-control включает англоязычные и китайские алиасы обнаружения для OBS, Open Broadcaster Software, записи, проверки сцен/источников, паузы, возобновления, 录屏 и 录制视频. Агенты ищут и загружают навык перед вызовом восьми конкретных инструментов из этого первого среза. Стриминг и переключение сцен остаются возможностями дорожной карты, а не поставляемыми нативными элементами управления.

Управление OBS — это в первую очередь нативный плагин/WebSocket. Неподдерживаемые визуальные действия могут использовать DCC-MCP ui-control с принадлежащим проекту DCC-CUA только после точной привязки PID и HWND, свежего снимка и чтения после действия. Универсального запасного варианта 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 и входные данные SDK OBS 31.1.1, зафиксированные с помощью SHA-256 хешей:

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

Эквивалентные сборки CI выполняются на Windows, macOS и Linux.

Граница валидации

Модульные тесты, фейковые сеансы протокола, нативная компиляция, смоук-тесты пакетов и CI не доказывают работу с лицензированным/живым хостом OBS. Эта начальная поставка не заявляет о приёмке на реальном OBS. Вопрос приёмки на одноразовом живом хосте остаётся отдельным шлюзом релиза.

Лицензия

GPL-2.0-or-later. Нативный модуль связывается с OBS Studio и поставляет официальный заголовок API плагина OBS WebSocket с его оригинальным уведомлением.

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