Beranda / Tutorial MCP / Menggunakan CLI

AppImage: solidcraft-cli & MCP

Verifikasi pada kotak Debian Linux melawan SolidCraftTOK0 (SolidCraft-0.30.0-linux-x86_64.AppImagedan matching.tar.gz / .debdariPengumuman GitHubNama-nama perintah Launcher, Snap dan Flatpak dariDokumen resmi MCP.

Jawaban singkat :setelah Anda menjalankan AppImage sekali, ia menulisSolidCraft-cliLuncurkan ke~/.local/bin(Jadi klien MCP dapat memanggilnya dengan nama jika folder itu berada diPATH) Titik masuk AppImage itu sendiri masihGUI yang (SolidCraft(dan tidak menerimamcpMenggunakan CLI mode sebagai extractorSolidCraft-clidari squashfs tetap menjadi alternatif yang valid;.tar.gz / .debMenempatkan kedua binari secara langsung pada disk.
Pada halaman ini Luncurkan pertama Apa yang kita lihat Cara Menggunakan AppImage Extract (alternate) Tar.gz dan deb Snap FlatPak Klien Konfigurasi

Launcher pertama yang masuk~/.local/bin

Dokumen MCP resmi: pada run pertama AppImage menulisSolidCraft-cliLuncurkan ke~/.local/bin• Pastikan~/.local/binDi dalam shell AndaPATH, restart klien MCP, lalu gunakanSolidCraft-cli mcpseperti paket lainnya. sejak 0.22.1 yang cocok dengan installer Windows dan aplikasi macOS (yang/opt/homebrew/binatau/usr/local/binDengan demikian, paket instalasi normal dapatSolidCraft-cliadalahPATHDeb, rpm dan FreeBSD sudah menginstal CLI di/usr/bin· Homebrew cask meletakkannyaPATHBegitu juga

Apa yang kita lihat (produksi terminal nyata)

Menggunakan AppImage secara langsung:

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

Jadi argv0 adalah aplikasi desktop, bukan 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)

Rename/symlinking dari AppImage keSolidCraft-cliSelanjutnyaSolidCraft 0.30.0(GUI biner) — tidak ada trik argv0 yang mengubah AppImage menjadi CLI.~/.local/binpeluncuran, atau jalan ekstrak di bawah ini.

Ekstrak AppImage (alternatif) untuk MCP

  1. DownloadnyaSolidCraft-0.30.0-linux-x86_64.AppImagedariPembebasan.
  2. chmod +x• AppImage (optional jika Anda hanya mengekstrak).
  3. Tambahkan 1 kali:./SolidCraft-…AppImage --appimage-extract
  4. Menempatkan klien MCP pada jalur mutlak…/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

Lebih suka tar.gz atau deb? keduanya kapal CLI

Untuk Linux.tar.gzLayout adalahbin/SolidCraft + bin/SolidCraft-cli(Selengkapnya) The.debMenempatkan pasangan yang sama di bawah/usr/bin/ (dpkg-deb -cUntuk mesin MCP-only, tarball adalah yang paling sederhana:

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

Dokumen resmi: setelahsudo snap install SolidCraftCLI tetap terhentiPATHDengan tujuan sebagaiSolidCraft.cli(TidakSolidCraft-cli) Sebagai contoh :SolidCraft.cli --version / SolidCraft.cli mcpMenggunakanSolidCraft.clisebagai klien MCP.commanddenganmcpSeperti halnya Argus.

FlatPak

Flatpak juga menahan CLIPATHBerdasarkan perintah resmi:

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

Dalam konfigurasi klien MCP,commandDuaflatpakdanargsDua["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](Selain itu, ada juga bendera lain seperti--allow-path).

Penulis: Claude Code, Claude Desktop, Cursor

Lebih sukaSolidCraft-clidengan nama ketika berada diPATH(AppImage launcher, deb, tarball). jika tidak, gunakan jalur mutlak ke ekstrak atau tarball CLI.

Kode Kode

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

atau.mcp.json:

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

Claude Desktop (tidak memiliki kepala)

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

Kursor

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

Untuk instalasi tarball, gunakan…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliUntuk Snap, gunakanSolidCraft.clisebagai nama perintah. untuk Flatpak,flatpakdenganrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Kembali ke UtamaTutorial MCP · Instalasi panduan.