AppImage: dov'è `solidcraft-cli` per MCP?

Verificato su un computer Debian Linux con SolidCraft v0.16.2 (solidcraft-0.16.2-linux-x86_64.AppImage e i corrispondenti .tar.gz / .deb dalle GitHub Releases). Nome della CLI di Snap tratto dalla guida ufficiale Getting started.

In breve: il punto di ingresso dell'AppImage è la GUI (solidcraft), che non accetta mcp come modalità CLI utilizzabile. L'eseguibile del server MCP, solidcraft-cli, è incluso dentro l'AppImage: estrailo oppure installa il .tar.gz / .deb, che copiano su disco entrambi gli eseguibili.

In questa pagina Cosa abbiamo visto Estrarre l'AppImage tar.gz e deb Snap Configurazione dei client

Cosa abbiamo visto (output reale del terminale)

Avviando direttamente l'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]

Quindi argv0 è l'app desktop, non la CLI. Dopo --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 …
# (server MCP stdio avviato; Ctrl-C / chiudere stdin per fermarlo)

Anche rinominando l'AppImage in solidcraft-cli o creando un link simbolico con quel nome, la risposta era sempre solidcraft 0.16.2 (l'eseguibile della GUI): non esiste un trucco con argv0 che trasformi l'AppImage nella CLI.

Procedura consigliata con l'AppImage per MCP

Scarica solidcraft-0.16.2-linux-x86_64.AppImage dalle Releases.
Esegui chmod +x sull'AppImage (facoltativo se ti limiti a estrarla).
Estraila una volta: ./solidcraft-…AppImage --appimage-extract
Nei client MCP indica il percorso assoluto …/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

Preferisci tar.gz o deb? Entrambi includono la CLI

Il .tar.gz per Linux contiene bin/solidcraft + bin/solidcraft-cli (verificato). Il .deb installa la stessa coppia in /usr/bin/ (dpkg-deb -c li elenca entrambi). Sui computer che servono solo per MCP, l'archivio tar è la soluzione più semplice:

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

Secondo la documentazione ufficiale, dopo sudo snap install solidcraft la CLI si chiama solidcraft.cli (non solidcraft-cli). Esempio: solidcraft.cli --version / solidcraft.cli mcp.

Claude Code, Claude Desktop, Cursor

Sostituisci il percorso del comando con quello della tua CLI estratta o presa dall'archivio tar. I percorsi assoluti evitano problemi con il PATH.

Claude Code

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

Oppure .mcp.json:

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

Claude Desktop (headless)

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

Se hai installato dall'archivio tar, usa invece …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli. Con Snap, usa solidcraft.cli come nome del comando.

Torna al tutorial MCP principale · guida all'installazione.