AppImage: Wo ist `solidcraft-cli` für MCP?

Geprüft auf einem Debian-Linux-Rechner mit SolidCraft v0.16.2 (solidcraft-0.16.2-linux-x86_64.AppImage sowie passende .tar.gz / .deb aus den GitHub-Releases). Name der Snap-CLI laut offiziellem „Getting started“.

Kurz gesagt: Der Einstiegspunkt des AppImage ist die GUI (solidcraft). Einen brauchbaren CLI-Modus mcp gibt es dort nicht. Das MCP-Server-Binary solidcraft-cli steckt im AppImage – extrahieren Sie es oder installieren Sie .tar.gz / .deb, die beide Binaries auf die Platte bringen.

Auf dieser Seite Was wir gesehen haben AppImage extrahieren tar.gz & deb Snap Client-Konfigurationen

Was wir gesehen haben (echte Terminalausgabe)

Das AppImage direkt ausgeführt:

$ ./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 ist also die Desktop-App, nicht die CLI. Nach --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 läuft; Beenden mit Strg+C bzw. durch Schließen von stdin)

Auch umbenannt oder per Symlink als solidcraft-cli meldete das AppImage weiterhin solidcraft 0.16.2 (GUI-Binary) – einen argv0-Trick, der das AppImage zur CLI macht, gibt es nicht.

Empfohlener AppImage-Workflow für MCP

solidcraft-0.16.2-linux-x86_64.AppImage von den Releases herunterladen.
Das AppImage mit chmod +x ausführbar machen (optional, wenn Sie nur extrahieren).
Einmalig extrahieren: ./solidcraft-…AppImage --appimage-extract
MCP-Clients auf den absoluten Pfad …/squashfs-root/usr/bin/solidcraft-cli verweisen lassen.

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

Lieber tar.gz oder deb? Beide enthalten die CLI

Das Linux-.tar.gz enthält bin/solidcraft + bin/solidcraft-cli (geprüft). Das .deb installiert dasselbe Paar unter /usr/bin/ (dpkg-deb -c listet beide). Für reine MCP-Rechner ist das Tarball am einfachsten:

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

Laut offizieller Dokumentation heißt die CLI nach sudo snap install solidcraft solidcraft.cli (nicht solidcraft-cli). Beispiel: solidcraft.cli --version / solidcraft.cli mcp.

Claude Code, Claude Desktop, Cursor

Ersetzen Sie den Befehlspfad durch Ihre extrahierte CLI bzw. die aus dem Tarball. Absolute Pfade vermeiden Probleme mit dem PATH.

Claude Code

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

Oder per .mcp.json:

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

Claude Desktop (headless)

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

Cursor

{
  "mcpServers": {
    "solidcraft": {
      "type": "stdio",
      "command": "/ABS/PFAD/squashfs-root/usr/bin/solidcraft-cli",
      "args": ["mcp", "--allow-path", "/absoluter/pfad/zu/ihren/konstruktionen"]
    }
  }
}

Bei einer Installation aus dem Tarball nehmen Sie stattdessen …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli. Bei Snap lautet der Befehlsname solidcraft.cli.

Zurück zum MCP-Tutorial · Installationsanleitung.