Startpagina / MCP-tutorial / AppImage CLI

AppImage: waar is solidcraft-cli voor MCP?

Gecontroleerd op een Debian Linux-machine met SolidCraft v0.22.0 (solidcraft-0.22.0-linux-x86_64.AppImage en bijbehorende .tar.gz / .deb van GitHub Releases). Launcher bij eerste run en Snap-/Flatpak-opdrachtnamen uit de officiële MCP-docs.

Kort antwoord: nadat je de AppImage één keer hebt gedraaid, schrijft hij een kleine solidcraft-cli-launcher naar ~/.local/bin (MCP-clients kunnen hem op naam aanroepen als die map op je PATH staat). Het AppImage-entry point zelf blijft de GUI (solidcraft) en accepteert mcp niet als nuttige CLI-modus. solidcraft-cli uit de squashfs extraheren blijft een geldig alternatief; .tar.gz / .deb zetten beide binaries direct op schijf.
Op deze pagina Launcher bij eerste run Wat we zagen AppImage-extractie (alternatief) tar.gz & deb Snap Flatpak Clientconfigs

Launcher bij eerste run in ~/.local/bin

Officiële MCP-docs: bij de eerste run schrijft de AppImage een kleine solidcraft-cli-launcher naar ~/.local/bin. Zorg dat ~/.local/bin op het shell-PATH staat, herstart de MCP-client en gebruik dan solidcraft-cli mcp zoals bij elk ander pakket. Deb, rpm en FreeBSD installeren de CLI al in /usr/bin; de Windows-installer en Homebrew-cask zetten hem ook op het PATH; de macOS-app koppelt bij het starten naar /opt/homebrew/bin of /usr/local/bin.

Wat we zagen (echte terminaluitvoer)

AppImage direct draaien:

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

Dus argv0 is de desktop-app, niet de CLI. Na --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)

Hernoemen/symlinken van de AppImage naar solidcraft-cli meldde nog steeds solidcraft 0.22.0 (GUI-binary) — geen argv0-truc maakt van de AppImage de CLI. Gebruik liever de launcher na de eerste run in ~/.local/bin, of het extractiepad hieronder.

AppImage-extractie (alternatief) voor MCP

  1. Download solidcraft-0.22.0-linux-x86_64.AppImage van Releases.
  2. chmod +x op de AppImage (optioneel als je alleen extracteert).
  3. Eenmaal extracten: ./solidcraft-…AppImage --appimage-extract
  4. Wijs MCP-clients naar het absolute pad …/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

Liever tar.gz of deb? Beide bevatten de CLI

De Linux-.tar.gz-indeling is bin/solidcraft + bin/solidcraft-cli (geverifieerd). Het .deb installeert hetzelfde paar onder /usr/bin/ (dpkg-deb -c toont beide). Voor MCP-only machines is de tarball het eenvoudigst:

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

Officiële docs: na sudo snap install solidcraft blijft de CLI expres buiten het PATH als solidcraft.cli (niet solidcraft-cli). Voorbeeld: solidcraft.cli --version / solidcraft.cli mcp. Gebruik solidcraft.cli als command van de MCP-client met mcp als args.

Flatpak

Flatpak houdt de CLI ook expres buiten het PATH. Officiële opdracht:

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

In een MCP-clientconfig zet je command op flatpak en args op ["run", "--command=solidcraft-cli", "ai.storyteller.solidcraft", "mcp"] (plus optionele flags zoals --allow-path).

Claude Code, Claude Desktop, Cursor

Gebruik solidcraft-cli op naam wanneer hij op het PATH staat (AppImage-launcher, deb, tarball). Anders een absoluut pad naar de geëxtraheerde of tarball-CLI.

Claude Code

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

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

Voor tarball-installaties gebruik …/solidcraft-0.22.0-linux-x86_64/bin/solidcraft-cli. Voor Snap: opdrachtnaam solidcraft.cli. Voor Flatpak: flatpak met run --command=solidcraft-cli ai.storyteller.solidcraft mcp.

Terug naar de MCP-tutorial · installatiegids.