deckapp-mcp

MCP 支持 DeckApp，让 Claude 等工具可以构建和运行你的 decks。无论 DeckApp 是否打开，它都使用与应用相同的 deck 文件。

环境要求

需要安装 DeckApp 3.0 或更高版本，并确保 import deckapp 可用。.deb 包会将其放入 /usr/lib/python3/dist-packages，如果你用 --system-site-packages 创建 virtualenv，就能看到它。

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"
    }
  }
}

请使用完整路径。只有 venv 中的 deckapp-mcp 才知道 DeckApp 的位置。

工具

共 26 个工具，覆盖与应用相同的功能：创建、重命名、调整大小、复制、重新排序和删除 decks；添加、编辑、移动和移除按钮；导入图标；读取和设置开关状态；以 JSON 格式导出和导入 deck；打开 deck 窗口。先运行 list_decks 查看你有哪些 id。

此外还有 press_button，它会运行按钮的命令并返回退出代码和输出。这样可以方便地检查 deck 是否正常工作，也意味着任何连接到该服务器的东西都可以运行你的 decks 能运行的任何内容。这相当于 shell 访问权限，请按此对待。

位置从 0 开始索引，第 0 行第 0 列为左上角的键。

许可证

MIT