AppImage: gdzie jest `solidcraft-cli` dla MCP?

Sprawdzone na komputerze z Debianem z SolidCraft v0.16.2 (solidcraft-0.16.2-linux-x86_64.AppImage oraz odpowiadające mu .tar.gz / .deb z GitHub Releases). Nazwa CLI w Snapie według oficjalnego Getting started.

Krótka odpowiedź: punktem wejścia AppImage jest GUI (solidcraft). Nie obsługuje on mcp jako użytecznego trybu CLI. Plik binarny serwera MCP, solidcraft-cli, jest spakowany wewnątrz AppImage – wypakuj go albo zainstaluj .tar.gz / .deb, które umieszczają na dysku oba pliki binarne.

Na tej stronie Co zobaczyliśmy Wypakowanie AppImage tar.gz i deb Snap Konfiguracje klientów

Co zobaczyliśmy (prawdziwe wyjście terminala)

Bezpośrednie uruchomienie AppImage:

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --version
solidcraft 0.16.2

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

Zatem argv0 to aplikacja desktopowa, a nie CLI. Po --appimage-extract:

$ ./solidcraft-0.16.2-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.16.2

$ ./squashfs-root/usr/bin/solidcraft-cli mcp
solidcraft mcp: files limited to …/recovery, /tmp/solidcraft-mcp-… and the open design's folder …
# (serwer MCP przez stdio działa; zatrzymasz go przez Ctrl+C lub zamknięcie stdin)

Po zmianie nazwy AppImage lub utworzeniu dowiązania symbolicznego solidcraft-cli program nadal zgłaszał solidcraft 0.16.2 (plik binarny GUI) – nie ma sztuczki z argv0, która zamieniłaby AppImage w CLI.

Zalecany sposób pracy z AppImage dla MCP

Pobierz solidcraft-0.16.2-linux-x86_64.AppImage ze strony Releases.
Nadaj plikowi AppImage uprawnienia chmod +x (opcjonalne, jeśli tylko go wypakowujesz).
Wypakuj go raz: ./solidcraft-…AppImage --appimage-extract
Wskaż klientom MCP bezwzględną ścieżkę …/squashfs-root/usr/bin/solidcraft-cli.

chmod +x solidcraft-0.16.2-linux-x86_64.AppImage
./solidcraft-0.16.2-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/solidcraft-cli mcp

Wolisz tar.gz lub deb? Oba zawierają CLI

Linuksowe archiwum .tar.gz ma układ bin/solidcraft + bin/solidcraft-cli (sprawdzone). Pakiet .deb instaluje tę samą parę w /usr/bin/ (dpkg-deb -c pokazuje oba pliki). Na maszynach tylko do MCP najprościej użyć archiwum tar:

tar -xzf solidcraft-0.16.2-linux-x86_64.tar.gz
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli --version
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli mcp

Snap

Oficjalna dokumentacja: po sudo snap install solidcraft CLI nazywa się solidcraft.cli (nie solidcraft-cli). Przykład: solidcraft.cli --version / solidcraft.cli mcp.

Claude Code, Claude Desktop, Cursor

Zastąp ścieżkę polecenia ścieżką do wypakowanego CLI lub CLI z archiwum tar. Ścieżki bezwzględne pozwalają uniknąć problemów z PATH.

Claude Code

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

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

Przy instalacji z archiwum tar użyj zamiast tego …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli. W przypadku Snapa jako nazwy polecenia użyj solidcraft.cli.

Wróć do głównego poradnika MCP · instrukcja instalacji.