Acasă / Tutoriale MCP / Imaginea CLI

AppImage: solidcraft-cli & MCP

Verificată pe o cutie Debian Linux împotriva SolidCraftv0.30.0 (SolidCraft-0.30.0-linux-x86_64.AppImageşi se potrivesc.tar.gz / .debdinGitHub elibereazăPrimul lansator, Snap și Flatpak nume de comandă dinDocumente oficiale MCP.

Răspunsul scurt:după ce rulați AppImage o dată, scrie o micăSolidCraft-cliLansare în~/.local/bin(deci clienții MCP îl pot numi pe nume dacă folderul respectiv se află pePATH) Punctul de intrare AppImage în sine este încăGui (SolidCraft(și nu acceptămcpca o modalitate CLI utilă. extragereaSolidCraft-clidin squash-uri rămâne o alternativă valabilă;.tar.gz / .debPuneți ambele binare direct pe disc.
Pe această pagină Primul lansator Ce am văzut Extras din AppImage (alternat) tar.gz și deb Snap flăcări Clientul configurează

Primul lansator în~/.local/bin

Documente oficiale MCP: la prima executare, AppImage scrie un micSolidCraft-cliLansare în~/.local/binAsigurați-vă că~/.local/binEste pe shell-ul tăuPATH, reporniţi clientul MCP, apoi utilizaţiSolidCraft-cli mcpca orice alt pachet. de la 0.22.1 care se potriveşte cu instalatorul Windows şi cu aplicaţia macOS (care/opt/homebrew/binsau/usr/local/bin, astfel încât un pachet normal de instalare puneSolidCraft-cliestePATHDeb, rpm și FreeBSD au instalat deja CLI-ul în/usr/binHomebrew Cask îl pune pePATHŞi de asemenea.

Ce am văzut (puterea reală a terminalului)

Rularea directă a AppImage:

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

Deci argv0 este aplicația desktop, nu 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)

Renumează/symlinkă AppImage laSolidCraft-cliÎncăSolidCraft 0.30.0(GUI binar) – nu există nici un truc argv0 care să transforme AppImage în CLI.~/.local/binlauncher, sau calea de extragere de mai jos.

Extractul AppImage (alternativ) pentru MCP

  1. DescărcareSolidCraft-0.30.0-linux-x86_64.AppImagedineliberări.
  2. chmod +xAppImage (opțional dacă extrageți numai).
  3. Extract de o dată:./SolidCraft-…AppImage --appimage-extract
  4. Punct clienți MCP pe calea absolută…/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

Prefer tar.gz sau deb? ambele nave CLI

pe linux.tar.gzLayout estebin/SolidCraft + bin/SolidCraft-cli(Controlul a fost făcut).debInstalează aceeaşi pereche sub/usr/bin/ (dpkg-deb -cPentru mașinile numai MCP, tarball-ul este cel mai simplu:

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

Documente oficiale: dupăsudo snap install SolidCraftCLI se opreștePATHÎn scopul caSolidCraft.cli(nu esteSolidCraft-cli• Exemplu :SolidCraft.cli --version / SolidCraft.cli mcpFoloseșteSolidCraft.cliÎn funcţie de client MCPcommandcumcpCa şi argumente.

flăcări

Flatpak păstrează, de asemenea, CLI offPATHprin design. comanda oficială:

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

Într-o configurare client MCP, setareacommanddouăflatpakşiargsdouă["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](In plus fata de flori, cum ar fi--allow-path).

Claude Code, Claude Desktop și Cursor

PreferăSolidCraft-cliNumele atunci când estePATH(AppImage launcher, deb, tarball). În caz contrar, utilizați o cale absolută la CLI extras sau tarball.

Codul lui Claude

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

sau.mcp.json:

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

Claude Desktop (fără cap)

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

cursorului

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

Pentru a instala tarball, utilizați…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliPentru Snap, utilizaţiSolidCraft.clica numele de comandă. Pentru Flatpak, utilizaţiflatpakcurun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Înapoi la principalTutoriale MCP · Instalarea ghidului.