Inicio / Tutorial MCP / AppImage CLI

AppImage: ¿dónde está solidcraft-cli para MCP?

Comprobado en una máquina Debian Linux con SolidCraft v0.22.0 (solidcraft-0.22.0-linux-x86_64.AppImage y los .tar.gz / .deb correspondientes de GitHub Releases). Lanzador del primer arranque y nombres de comando Snap/Flatpak de la documentación oficial de MCP.

Respuesta breve: tras ejecutar el AppImage una vez, escribe un pequeño lanzador solidcraft-cli en ~/.local/bin (los clientes MCP pueden llamarlo por nombre si esa carpeta está en su PATH). El punto de entrada del AppImage sigue siendo la GUI (solidcraft) y no acepta mcp como modo CLI útil. Extraer solidcraft-cli del squashfs sigue siendo una alternativa válida; .tar.gz / .deb ponen ambos binarios directamente en disco.
En esta página Lanzador del primer arranque Lo que vimos Extraer el AppImage (alternativa) tar.gz y deb Snap Flatpak Configs de cliente

Lanzador del primer arranque en ~/.local/bin

Docs oficiales de MCP: en el primer arranque el AppImage escribe un pequeño lanzador solidcraft-cli en ~/.local/bin. Asegúrese de que ~/.local/bin está en el PATH del shell, reinicie el cliente MCP y use solidcraft-cli mcp como con cualquier otro paquete. Deb, rpm y FreeBSD ya instalan el CLI en /usr/bin; el instalador de Windows y Homebrew cask también lo ponen en el PATH; la app de macOS enlaza en /opt/homebrew/bin o /usr/local/bin al iniciar.

Lo que vimos (salida real de terminal)

Ejecutar el AppImage directamente:

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

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

Así que argv0 es la app de escritorio, no el CLI. Tras --appimage-extract:

$ ./solidcraft-0.22.0-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.22.0

$ ./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)

Renombrar/enlazar el AppImage a solidcraft-cli seguía informando solidcraft 0.22.0 (binario GUI) — no hay truco de argv0 que convierta el AppImage en el CLI. Prefiera el lanzador del primer arranque en ~/.local/bin, o la ruta de extracción de abajo.

Extraer el AppImage (alternativa) para MCP

  1. Descargue solidcraft-0.22.0-linux-x86_64.AppImage desde Releases.
  2. chmod +x al AppImage (opcional si solo extrae).
  3. Extraiga una vez: ./solidcraft-…AppImage --appimage-extract
  4. Apunte a los clientes MCP la ruta absoluta …/squashfs-root/usr/bin/solidcraft-cli.
chmod +x solidcraft-0.22.0-linux-x86_64.AppImage
./solidcraft-0.22.0-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/solidcraft-cli mcp

¿Prefiere tar.gz o deb? Ambos traen el CLI

El layout Linux .tar.gz es bin/solidcraft + bin/solidcraft-cli (comprobado). El .deb instala el mismo par en /usr/bin/ (dpkg-deb -c lista ambos). En máquinas solo para MCP, el tarball es lo más sencillo:

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

Snap

Docs oficiales: tras sudo snap install solidcraft, el CLI queda a propósito fuera del PATH como solidcraft.cli (no solidcraft-cli). Ejemplo: solidcraft.cli --version / solidcraft.cli mcp. Use solidcraft.cli como command del cliente MCP con mcp en los args.

Flatpak

Flatpak también deja el CLI fuera del PATH a propósito. Comando oficial:

flatpak run --command=solidcraft-cli ai.storyteller.solidcraft mcp

En la config del cliente MCP, ponga command en flatpak y args en ["run", "--command=solidcraft-cli", "ai.storyteller.solidcraft", "mcp"] (más flags opcionales como --allow-path).

Claude Code, Claude Desktop, Cursor

Prefiera solidcraft-cli por nombre cuando esté en el PATH (lanzador AppImage, deb, tarball). Si no, una ruta absoluta al CLI extraído o del tarball.

Claude Code

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

O .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"]
    }
  }
}

En instalaciones tarball, use …/solidcraft-0.22.0-linux-x86_64/bin/solidcraft-cli. En Snap, el nombre de comando solidcraft.cli. En Flatpak, flatpak con run --command=solidcraft-cli ai.storyteller.solidcraft mcp.

Volver al tutorial MCP · guía de instalación.