deckapp-mcp

Поддержка MCP для DeckApp, чтобы такие инструменты, как Claude, могли создавать и запускать ваши панели. Он работает с теми же файлами панелей, что и приложение, независимо от того, открыт ли DeckApp.

Требования

DeckApp 3.0 или новее, установленный так, чтобы работал import deckapp. Пакет .deb помещает его в /usr/lib/python3/dist-packages, который virtualenv может увидеть, если создать его с --system-site-packages.

Related MCP server: streamdeck-mcp

Установка

git clone https://github.com/prabhatm021/deckapp-mcp.git
cd deckapp-mcp
python3 -m venv --system-site-packages .venv
.venv/bin/pip install .

Проверьте, что DeckApp найден:

.venv/bin/python -c "import deckapp; print(deckapp.__version__)"

Подключение

Claude Code:

claude mcp add deckapp -- /path/to/deckapp-mcp/.venv/bin/deckapp-mcp

Claude Desktop или любой клиент с JSON-конфигурацией:

{
  "mcpServers": {
    "deckapp": {
      "command": "/path/to/deckapp-mcp/.venv/bin/deckapp-mcp"
    }
  }
}

Используйте полный путь. Именно deckapp-mcp из venv знает, где находится DeckApp.

Инструменты

Их 26, и они покрывают те же возможности, что и приложение: создавать, переименовывать, изменять размер, дублировать, изменять порядок и удалять панели; добавлять, редактировать, перемещать и удалять кнопки; импортировать значки; читать и устанавливать состояния переключателей; экспортировать и импортировать панель в JSON; открывать окно панели. Сначала выполните list_decks, чтобы увидеть, какие у вас есть id.

Есть также press_button, который выполняет команду кнопки и возвращает код выхода и вывод. Это позволяет легко проверить, что панель работает, и означает, что любой клиент, подключённый к этому серверу, может запускать всё, что запускают ваши панели. Это доступ к оболочке, поэтому относитесь к нему соответственно.

Позиции индексируются с нуля: строка 0, столбец 0 — это верхняя левая кнопка.

Лицензия

MIT