AppImage : où est `solidcraft-cli` pour MCP ?

Vérifié sur une machine Debian Linux avec SolidCraft v0.16.2 (solidcraft-0.16.2-linux-x86_64.AppImage et les .tar.gz / .deb correspondants, issus des GitHub Releases). Nom de la CLI Snap d’après le guide officiel Getting started.

En bref : le point d’entrée de l’AppImage est l’interface graphique (solidcraft). Elle n’accepte pas mcp comme mode CLI exploitable. Le binaire du serveur MCP, solidcraft-cli, est empaqueté à l’intérieur de l’AppImage : extrayez-le, ou installez le .tar.gz / .deb, qui placent les deux binaires sur le disque.

Sur cette page Ce que nous avons constaté Extraire l’AppImage tar.gz et deb Snap Configurations client

Ce que nous avons constaté (sortie réelle du terminal)

En lançant directement 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]

argv0 correspond donc à l’application de bureau, pas à la CLI. Après --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)

Renommée en solidcraft-cli (ou via un lien symbolique), l’AppImage affichait toujours solidcraft 0.16.2 (binaire de l’interface graphique) : aucune astuce sur argv0 ne transforme l’AppImage en CLI.

Procédure AppImage recommandée pour MCP

Téléchargez solidcraft-0.16.2-linux-x86_64.AppImage depuis les Releases.
Appliquez chmod +x à l’AppImage (facultatif si vous ne faites que l’extraire).
Extrayez-la une fois : ./solidcraft-…AppImage --appimage-extract
Indiquez aux clients MCP le chemin absolu …/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

Vous préférez le tar.gz ou le deb ? Les deux contiennent la CLI

L’archive Linux .tar.gz contient bin/solidcraft + bin/solidcraft-cli (vérifié). Le .deb installe la même paire sous /usr/bin/ (dpkg-deb -c liste les deux). Pour une machine dédiée à MCP, l’archive tar est la solution la plus simple :

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

Documentation officielle : après sudo snap install solidcraft, la CLI s’appelle solidcraft.cli (et non solidcraft-cli). Exemple : solidcraft.cli --version / solidcraft.cli mcp.

Claude Code, Claude Desktop, Cursor

Remplacez le chemin de la commande par celui de votre CLI extraite ou issue de l’archive tar. Les chemins absolus évitent les problèmes de PATH.

Claude Code

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

Ou dans .mcp.json :

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

Claude Desktop (sans interface graphique)

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

Pour une installation depuis l’archive tar, utilisez plutôt …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli. Pour Snap, utilisez solidcraft.cli comme nom de commande.

Retour au tutoriel MCP principal · guide d’installation.