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.
Настройка клиентов
{
"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.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.