Domů / MCP tutoriál / AppImage CLI

AppImage: solidcraft-cli & MCP

Ověřeno na boxu Debian Linux proti SolidCraftTOK0 (SolidCraft-0.30.0-linux-x86_64.AppImagea odpovídající.tar.gz / .debodGitHub vydáníPrvní spouštěč, Snap a Flatpak příkazové názvy zOficiální MCP docs.

Krátká odpověď :po spuštění aplikace AppImage jednou, napíše malouSolidCraft-cliLauncher do~/.local/bin(takže klient MCP může volat jméno, pokud je tato složka na vašemPATHSamotný vstupní bod AppImage je stáleGui (SolidCrafta) nepřijímámcpjako užitečný CLI režim. extrahováníSolidCraft-cliz squashů zůstává platná alternativa;.tar.gz / .debVložte oba binární soubory přímo na disk.
Na této stránce První launcher Co jsme viděli Extrakt z AppImage (alternativní) Tar.gz a deb Snapy Flatpak Zákazník Config

První start start do~/.local/bin

Oficiální doklady MCP: při prvním spuštění aplikace AppImageSolidCraft-cliLauncher do~/.local/binUjistěte se~/.local/binJe na vaší shellPATH, restartujte klienta MCP a poté použijteSolidCraft-cli mcpjako jakýkoli jiný balíček. od 0.22.1, který odpovídá instalačnímu programu Windows a aplikaci macOS (která odkazuje na/opt/homebrew/binnebo/usr/local/bin), takže normální balíček instalujeSolidCraft-clijePATHDeb, rpm a FreeBSD již nainstalovaly CLI/usr/bin; Homebrew cask to položí naPATHA taky .

Co jsme viděli (reálný výstup terminálu)

Spuštění AppImage přímo:

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

Takže argv0 je desktopová aplikace, nikoliv 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)

Přejmenování/symlinkování AppImage naSolidCraft-cliStáleSolidCraft 0.30.0(GUI binární) – neexistuje žádný argv0 trik, který by přeměnil AppImage na CLI.~/.local/binspouštěč, nebo extrahovat cestu níže.

Extrakt AppImage (alternativní) pro MCP

  1. DownloadovánoSolidCraft-0.30.0-linux-x86_64.AppImageodosvobození.
  2. chmod +xAppImage (volitelné, pokud chcete pouze extrahovat).
  3. Extrakt jednou:./SolidCraft-…AppImage --appimage-extract
  4. Pointa klientů MCP na absolutní cestě…/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

Preferujete tar.gz nebo deb? oba lodě CLI

O Linuxu.tar.gzLayout jebin/SolidCraft + bin/SolidCraft-cli(Ověřeno) Na.debNainstalujte stejný pár pod/usr/bin/ (dpkg-deb -cU MCP-only strojů je tarball nejjednodušší:

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

Snapy

Oficiální doklady: posudo snap install SolidCraftCLI se zastavujePATHZa účelem jakoSolidCraft.cli(NeníSolidCraft-cli) Příklad :SolidCraft.cli --version / SolidCraft.cli mcpPoužívejteSolidCraft.cliJako klient MCPcommandsmcpStejně jako Argos.

Flatpak

Flatpak také drží CLI offPATHOficiální příkaz: Oficiální příkaz:

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

V MCP client config, nastavenícommandDvěflatpakaargsDvě["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](a další vlajky, jako jsou--allow-path).

Claude Code, Claude Desktop, kurzor

RadějiSolidCraft-cliJméno, když je naPATH(AppImage launcher, deb, tarball). Jinak použijte absolutní cestu k extrahované nebo tarball CLI.

Claude Kód

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

nebo.mcp.json:

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

Claude Desktop (bez hlavy)

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

kurzorem

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

Pro instalaci tarballu použijte…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliMísto toho. pro Snap, použijteSolidCraft.clijako příkazové jméno. Pro Flatpak použijteflatpaksrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Zpět na HlavníMCP tutoriál · Instalace průvodce.