AppImage: solidcraft-cli & MCP

Verificeret på en Debian Linux-boks mod SolidCraftTOK0 (SolidCraft-0.30.0-linux-x86_64.AppImageog matchende.tar.gz / .debfraGitHub udgivelser) Første lancering, Snap og Flatpak kommandoer navne fraOfficielle MCP-dokumenter.

Det korte svar:når du kører AppImage én gang, skriver den en lilleSolidCraft-cliLauncher til~/.local/bin(så MCP-klienter kan kalde det ved navn, hvis den mappe er på dinPATH) AppImage indgangspunktet selv er stadigaf Gui (SolidCraft) og accepterer ikkemcpsom en nyttig CLI-tilstand. udtrækSolidCraft-clifra squashf'erne forbliver en gyldig alternativ;.tar.gz / .debSæt begge binære filer direkte på disken.

Første lancering i~/.local/bin

Officielle MCP-dokumenter: I første omgang skriver AppImage en lilleSolidCraft-cliLauncher til~/.local/binSørg for~/.local/binDet er på din shellPATHgenstarte MCP-klienten, og derefter brugeSolidCraft-cli mcpsiden 0.22.1, der matcher Windows-installatøren og macOS-appen (som linker til/opt/homebrew/bineller/usr/local/bin), så en normal pakke installererSolidCraft-clierPATHDeb, rpm og FreeBSD har allerede installeret CLI i/usr/binHomebrew cask sætter det påPATHOgså det.

Hvad vi så (real terminal output)

Kør AppImage direkte:

$ ./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 er desktop-appen, ikke 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)

Omdøb/symlink AppImage tilSolidCraft-cliFortsat i øvrigtSolidCraft 0.30.0(GUI binær) — der er ingen argv0 trick, der omdanner AppImage til CLI.~/.local/binLauncher, eller udtrækslinjen nedenfor.

AppImage-ekstrakt (alternativ) til MCP

  1. Download afSolidCraft-0.30.0-linux-x86_64.AppImagefraFrigør.
  2. chmod +xAppImage (valgfrit, hvis du kun udtrækker).
  3. Uddrag én gang:./SolidCraft-…AppImage --appimage-extract
  4. Point MCP-klienter på den absolutte vej…/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

Foretrækker tar.gz eller deb? begge skibe CLI

af Linux.tar.gzLayout erbin/SolidCraft + bin/SolidCraft-cli(Overvåget) Den.debIndsæt det samme par under/usr/bin/ (dpkg-deb -cFor MCP-kun maskiner er tarballen den enkleste:

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

Snap

Officielle dokumenter: eftersudo snap install SolidCraftCLI holder sig vækPATHMed henblik somSolidCraft.cli(Nej ikkeSolidCraft-cli) Eksempel på:SolidCraft.cli --version / SolidCraft.cli mcpBrug afSolidCraft.cliSom MCP-klientcommandmedmcpLigesom med Argos.

Flatpak

Flatpak holder også CLI'en udePATHaf design. Officiel kommando:

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

I en MCP-klientkonfiguration indstillescommandTo afflatpakogargsTo af["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](Og derudover er der også andre flager, som--allow-path).

Claude Code, Claude Desktop og Cursor

ForetrækkerSolidCraft-cliVed navn, når det erPATH(AppImage launcher, deb, tarball). Ellers bruge en absolut vej til den ekstraherede eller tarball CLI.

Claude Kode

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

Anmeldelse af 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"]
    }
  }
}

For tarball installerer, brug…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-clii stedet. For Snap, brugSolidCraft.clisom kommandonavnet. For Flatpak skal du brugeflatpakmedrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Tilbage til det vigtigsteMCP Tutorials · Installation af guide.