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-server

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

• Стриминг, буфер повтора, виртуальная камера и выходы

• Профили, коллекции сцен, ограниченные горячие клавиши, скриншоты и статус оператора

• Приемка на одноразовом реальном OBS

• Входы, свойства, фильтры, аудио и медиа

• Граф сцен, переключение, переходы и Studio Mode

Требования

• 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 с его оригинальным уведомлением.