AppImage：MCP 用の `solidcraft-cli` はどこ？

Debian Linux マシンで SolidCraft v0.16.2 を使って検証しました（GitHub Releases の solidcraft-0.16.2-linux-x86_64.AppImage と、同じバージョンの .tar.gz / .deb）。Snap の CLI 名は公式の Getting started によります。

結論：AppImage のエントリーポイントは GUI （solidcraft）です。mcp を有効な CLI モードとして受け付けません。 MCP サーバーのバイナリ solidcraft-cli は AppImage の中に同梱されているので、それを展開するか、両方のバイナリがディスクに配置される .tar.gz / .deb をインストールしてください。

このページの内容 検証結果 AppImage の展開 tar.gz と deb Snap クライアントの設定

検証結果（実際のターミナル出力）

AppImage を直接実行した場合：

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --version
solidcraft 0.16.2

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --help
usage: solidcraft [--control PORT] [--sample] [--crash-log] [--safe-mode] [design.solidcraft | part.step]

つまり argv0 はデスクトップアプリであり、CLI ではありません。--appimage-extract の後は次のとおりです：

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --appimage-extract
$ ls squashfs-root/usr/bin/
solidcraft
solidcraft-cli
solvecraft-cli

$ ./squashfs-root/usr/bin/solidcraft-cli --version
solidcraft-cli 0.16.2

$ ./squashfs-root/usr/bin/solidcraft-cli mcp
solidcraft mcp: files limited to …/recovery, /tmp/solidcraft-mcp-… and the open design's folder …
# (stdio MCP server started; Ctrl-C / close stdin to stop)

AppImage を solidcraft-cli という名前に変更したりシンボリックリンクを作成したりしても、表示は solidcraft 0.16.2 （GUI のバイナリ）のままでした。argv0 を工夫して AppImage を CLI として動かす方法はありません。

MCP 向けの AppImage の推奨手順

Releases から solidcraft-0.16.2-linux-x86_64.AppImage をダウンロードします。
AppImage に chmod +x を実行します（展開するだけなら省略可）。
一度だけ展開します：./solidcraft-…AppImage --appimage-extract
MCP クライアントには絶対パス …/squashfs-root/usr/bin/solidcraft-cli を指定します。

chmod +x solidcraft-0.16.2-linux-x86_64.AppImage
./solidcraft-0.16.2-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/solidcraft-cli mcp

tar.gz や deb を使う場合：どちらにも CLI が同梱

Linux 用 .tar.gz の構成は bin/solidcraft + bin/solidcraft-cli です（検証済み）。.deb は同じ 2 つを /usr/bin/ にインストールします（dpkg-deb -c で両方が表示されます）。MCP 専用のマシンなら、tarball がいちばん簡単です：

tar -xzf solidcraft-0.16.2-linux-x86_64.tar.gz
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli --version
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli mcp

Snap

公式ドキュメントによると、sudo snap install solidcraft の後、CLI の名前は solidcraft.cli です（solidcraft-cli ではありません）。例： solidcraft.cli --version / solidcraft.cli mcp。

Claude Code、Claude Desktop、Cursor

コマンドのパスは、展開した CLI または tarball の CLI のパスに置き換えてください。絶対パスにすると PATH の問題を避けられます。

Claude Code

claude mcp add solidcraft -- /ABS/PATH/squashfs-root/usr/bin/solidcraft-cli mcp

または .mcp.json：

{
  "mcpServers": {
    "solidcraft": {
      "command": "/ABS/PATH/squashfs-root/usr/bin/solidcraft-cli",
      "args": ["mcp"]
    }
  }
}

Claude Desktop（ヘッドレス）

{
  "mcpServers": {
    "solidcraft": {
      "command": "/ABS/PATH/squashfs-root/usr/bin/solidcraft-cli",
      "args": ["mcp"]
    }
  }
}

Cursor

{
  "mcpServers": {
    "solidcraft": {
      "type": "stdio",
      "command": "/ABS/PATH/squashfs-root/usr/bin/solidcraft-cli",
      "args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
    }
  }
}

tarball でインストールした場合は、代わりに …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli を使います。 Snap の場合は、コマンド名に solidcraft.cli を指定します。

MCP チュートリアルに戻る · インストールガイド