deckapp-mcp

DeckApp 向けの MCP サポートです。これにより、Claude などのツールでデッキをビルドして実行できます。DeckApp が開いているかどうかに関係なく、アプリと同じデッキファイルで動作します。

要件

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

フルパスを使用してください。DeckApp の場所を知っているのは、venv の deckapp-mcp です。

ツール

ツールは 26 個あり、アプリと同じ範囲をカバーしています: デッキの作成、名前変更、サイズ変更、複製、並べ替え、削除、ボタンの追加、編集、移動、削除、アイコンのインポート、トグル状態の読み取りと設定、デッキの JSON エクスポート/インポート、デッキウィンドウを開くことです。最初に list_decks を実行して、自分の ID を確認してください。

さらに press_button もあります。これはボタンのコマンドを実行し、終了コードと出力を返します。これによりデッキが動作するかどうかを簡単に確認でき、また、このサーバーに接続されたものは、デッキが実行するあらゆるコマンドを実行できることを意味します。これはシェルアクセスなので、そのように扱ってください。

位置はゼロから始まるインデックスです。行 0 列 0 が左上のキーになります。

ライセンス

MIT