streamdeck-mcp

streamdeck-mcp — MCP-сервер сообщества (автор — verygoodplugins). Управление Elgato Stream Deck: кнопки, страницы и действия. Ставится через uvx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
verygoodplugins
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

Пишет профили Elgato и исполняемые скрипты в ~/StreamDeckScripts/, перезапускает приложение Stream Deck.

Настройка клиентов

codex
{
    "code": "[mcp_servers.streamdeck]\ncommand = \"uvx\"\nargs = [\"streamdeck-mcp\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "verified": "docs"
}

Что умеет

Stream Deck MCP позволяет агентам создавать и перенастраивать настоящие профили Elgato Stream Deck. Опишите, какой пульт вам нужен, — и получите готовый профиль с кнопками, иконками, цветами, энкодерами, картинками для сенсорной полосы и скриптами оболочки за ними. Сервер пишет тот же формат профилей, что использует приложение Elgato, поэтому агент собирает реальные локальные панели без разработки отдельного плагина Stream Deck.

Возможности:

  • Работа с родным форматом — чтение и запись файлов ProfilesV3 с запасным вариантом ProfilesV2 для старых установок.
  • Инвентаризация железа — страницы профилей, модели устройств, раскладка клавиш, энкодеры и сенсорная полоса определяются до записи.
  • Поиск настроенных действий — streamdeck_find_actions находит в существующих профилях готовые кнопки и энкодеры плагинов, включая защищённые плагины Elgato; приватные настройки при копировании сохраняются.
  • Обзор установленных плагинов — идентификаторы плагинов и действий из манифестов.
  • Офлайн-иконки — около 7400 встроенных иконок Material Design или короткие текстовые надписи.
  • Автоматизации на скриптах — исполняемые скрипты оболочки в ~/StreamDeckScripts/, привязанные к действию Open, когда подходящего плагина нет.
  • Безопасный цикл записи — закрыть приложение, записать, запустить снова, чтобы Elgato не перезаписал изменения.

Инструменты: streamdeck_find_actions, streamdeck_read_plugins, streamdeck_read_profiles, streamdeck_read_page, streamdeck_write_page, streamdeck_create_icon, streamdeck_create_action, streamdeck_restart_app и streamdeck_install_mcp_plugin. Для клиентов без навыков есть промпт design_streamdeck_deck.

Сценарии: пульт для Slack со статусами и переходами по каналам; панель Home Assistant для гостиной; пульт OBS по вашим сценам и аудиовходам; панель разработчика с командами проекта, ссылками на PR и CI. Лучше всего работает вместе с другими MCP-серверами — Slack, Home Assistant, OBS, GitHub, Hue, Spotify.

Кому подойдёт

Владельцам Stream Deck, стримерам и разработчикам, которые хотят собирать тематические панели словами, а не вручную. Похожие серверы — в категории автоматизация и IoT.

Установка

Сервер запускается через uvx streamdeck-mcp. Основной режим рассчитан на приложение Elgato Stream Deck для macOS и Windows; на Linux и без графики используйте прежний USB-сервер uvx --from streamdeck-mcp streamdeck-mcp-usb, который управляет устройством напрямую. Для Claude Code есть навык оформления: uvx --from streamdeck-mcp streamdeck-mcp-install-skill.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add streamdeck -- uvx streamdeck-mcp

Файлы: Claude Desktop на macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, Cursor — ~/.cursor/mcp.json, Codex — ~/.codex/config.toml.

Проверка

Попросите: «Покажи мои профили Stream Deck и подключённые устройства».

Примеры задач

Сделай пульт управления Slack для моего Stream Deck + XL.
Панель OBS по моим сценам в северной палитре.

Риски

  • Создание исполняемых скриптов. Агент пишет скрипты оболочки в ~/StreamDeckScripts/ и привязывает их к кнопкам — проверяйте их перед нажатием.
  • Перезапись профилей. Сервер меняет файлы профилей Elgato и может закрыть и перезапустить приложение; сохраните резервную копию профилей.
  • Иконки создаются офлайн и хранятся в ~/.streamdeck-mcp/generated-icons/.

Частые вопросы

Работает ли на Linux?

Да, через прежний USB-режим.

Нужно ли писать плагин?

Нет, сервер пишет профили в формате приложения Elgato.

Почему приложение закрывается при записи?

Иначе Elgato перезапишет изменения при выходе.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники