Hem / MCP Tutorials / AppImage CLI

AppImage: solidcraft-cli & MCP

Verifierad på en Debian Linux-låda mot SolidCraftv0.30.0 (SolidCraft-0.30.0-linux-x86_64.AppImageoch matchning.tar.gz / .debfrånGitHub släppsFörsta körning av launcher, Snap och Flatpak kommandonamn frånOfficiella MCP-dokument.

Ett kort svar:när du kör AppImage en gång, skriver den en litenSolidCraft-cliLauncher in i~/.local/bin(så att MCP-klienter kan kalla den vid namn om den mappen är på dinPATHAppImage-ingångspunkten själv är fortfarande denGui (SolidCraft) och accepterar intemcpsom ett användbart CLI-läge. utvinningSolidCraft-clifrån squashfs förblir en giltig alternativ;.tar.gz / .debSätt båda binärerna direkt på skivan.
På denna sida Första launcher Vad vi såg AppImage extrakt (alternativ) tar.gz och deb snapp Flatpak Kundkonfiguration

Första launcher in~/.local/bin

Officiella MCP-dokument: vid första körningen skriver AppImage en litenSolidCraft-cliLauncher in i~/.local/binSe till att~/.local/binär på din shellPATHStarta om MCP-klienten och använd sedanSolidCraft-cli mcpsedan 0.22.1 som matchar Windows-installatören och macOS-appen (som länkar till/opt/homebrew/bineller/usr/local/bin), så ett normalt paket installerarSolidCraft-cliärPATHDeb, rpm och FreeBSD har redan installerat CLI i/usr/binHomebrew cask sätter det påPATHOch också .

Vad vi såg (real terminal output)

Kör AppImage direkt:

$ ./SolidCraft-0.30.0-linux-x86_64.AppImage --version
SolidCraft 0.30.0

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

Så argv0 är skrivbordsappen, inte CLI.--appimage-extract:

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

Omnämna/symlänka AppImage tillSolidCraft-cliFortfarandeSolidCraft 0.30.0(GUI binär) – det finns inget argv0 trick som förvandlar AppImage till CLI.~/.local/binlauncher, eller extrahera vägen nedanför.

AppImage extrakt (alternativ) för MCP

  1. NedladdningSolidCraft-0.30.0-linux-x86_64.AppImagefrånFrigör.
  2. chmod +xAppImage (valfritt om du bara extraherar).
  3. Extraherad en gång:./SolidCraft-…AppImage --appimage-extract
  4. Peka MCP-klienter på den absoluta vägen…/squashfs-root/usr/bin/SolidCraft-cli.
chmod +x SolidCraft-0.30.0-linux-x86_64.AppImage
./SolidCraft-0.30.0-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/SolidCraft-cli mcp

Föredrar tar.gz eller deb? båda fartyg CLI

och Linux.tar.gzlayout ärbin/SolidCraft + bin/SolidCraft-cli(Kontrollerad) Den.debInstallera samma par under/usr/bin/ (dpkg-deb -cFör MCP-bara maskiner är tarballen den enklaste:

tar -xzf SolidCraft-0.30.0-linux-x86_64.tar.gz
./SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cli --version
./SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cli mcp

snapp

Officiell dokumentation: eftersudo snap install SolidCraftCLI stannar avPATHI syfte somSolidCraft.cli(Nej inteSolidCraft-cli) Exempel påSolidCraft.cli --version / SolidCraft.cli mcp• AnvändSolidCraft.clisom en MCP-klientcommandmedmcpPrecis som Argos.

Flatpak

Flatpak håller också CLI avPATHav design. Officiell kommando:

flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft mcp

I en MCP-klientkonfiguration ställscommandTvåflatpakochargsTvå["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](Förutom andra flaggor som--allow-path).

Claude Code, Claude Desktop och Cursor

FöredrarSolidCraft-cliNamnet när det är påPATH(AppImage launcher, deb, tarball). Annars använder du en absolut väg till den extraherade eller tarball CLI.

Claude Koden

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

eller.mcp.json:

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

Följ Claude Desktop (headless)

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

Kursör

{
  "mcpServers": {
    "SolidCraft": {
      "type": "stdio",
      "command": "/ABS/PATH/squashfs-root/usr/bin/SolidCraft-cli",
      "args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
    }
  }
}

För tarball installerar, använd…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-clii stället. För Snap, användSolidCraft.clisom kommandotalet. För Flatpak, användflatpakmedrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Tillbaka till huvudMCP Tutorials · Installerad guide.