Laman utama / Tag: tutorial MCP / Perkhidmatan CLI

AppImage: solidcraft-cli & MCP

Diuji pada kotak Debian Linux terhadap SolidCraft_Tok0_ (SolidCraft-0.30.0-linux-x86_64.AppImagedan matching.tar.gz / .debdaripadaGitHub PembebasanNama perintah Launcher pertama, Snap dan Flatpak daripadaDokumen MCP rasmi.

Jawapan singkat :selepas anda menjalankan AppImage sekali, ia menulisSolidCraft-cliLauncher dalam~/.local/bin(maka klien MCP boleh memanggilnya dengan nama jika folder itu berada padaPATH) Titik kemasukan AppImage itu sendiri masihMelayu (SolidCraft) dan tidak menerimamcpsebagai mod CLI berguna. mengekstrakSolidCraft-clidaripada squashfs kekal alternatif yang sah;.tar.gz / .debLetakkan kedua-dua binari secara langsung pada cakera.
Pada halaman ini Pelancaran pertama Apa yang kita lihat Perbezaan Perbezaan (alternate) tar.gz dan deb Snap Flatpak Pelanggan Config

Launcher pertama dalam~/.local/bin

Dokumen MCP rasmi: pada kali pertama, AppImage menulisSolidCraft-cliLauncher dalam~/.local/binPastikan anda~/.local/binDi dalam shell andaPATH, memulakan semula klien MCP, kemudian gunakanSolidCraft-cli mcpdaripada 0.22.1 yang sesuai dengan pemasang Windows dan aplikasi macOS (yang/opt/homebrew/binatau/usr/local/bin), jadi satu paket normal install putsSolidCraft-cliialahPATHDeb, rpm dan FreeBSD telah memasang CLI dalam/usr/binHomebrew cask meletakkannya padaPATHdan juga

Apa yang kita lihat (hasil terminal sebenar)

Menjalankan 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 ialah 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)

Menamakan semula/symlinking AppImage kepadaSolidCraft-climasih bolehSolidCraft 0.30.0(GUI binari) — tiada trik argv0 yang mengubah AppImage menjadi CLI.~/.local/binpelancaran, atau jalan ekstrak di bawah.

Ekstrak AppImage (alternate) untuk MCP

  1. Download daripadaSolidCraft-0.30.0-linux-x86_64.AppImagedaripadaPembebasan.
  2. chmod +xAppImage (optional jika anda hanya mengekstrak).
  3. Tambahan sekali :./SolidCraft-…AppImage --appimage-extract
  4. Tarik klien MCP di jalan 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? kedua-dua kapal CLI

daripada linux.tar.gzLayout ialahbin/SolidCraft + bin/SolidCraft-cli(Selengkapnya) The.debMasukkan pasangan yang sama di bawah/usr/bin/ (dpkg-deb -cUntuk mesin MCP sahaja, tarball adalah yang paling mudah:

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 rasmi: selepassudo snap install SolidCraft, CLI tinggal offPATHUntuk tujuan sepertiSolidCraft.cli(TidakSolidCraft-cli) Contoh :SolidCraft.cli --version / SolidCraft.cli mcp· GunakanSolidCraft.clisebagai klien MCPcommanddenganmcpSeperti yang args.

Flatpak

Flatpak juga mengekalkan CLIPATHPerkhidmatan Perkhidmatan : Perintah Perkhidmatan :

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

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

Claude Code, Claude Desktop dan Cursor

Lebih sukaSolidCraft-clidengan nama apabila terdapatPATH(AppImage launcher, deb, tarball). jika tidak, gunakan laluan mutlak kepada CLI yang diekstrak atau tarball.

Kode Claude

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 mempunyai 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 memasang tarball, gunakan…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliUntuk Snap, gunakanSolidCraft.clisebagai nama perintah. untuk Flatpak, gunakanflatpakdenganrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Kembali kepada UtamaTag: tutorial MCP · Instalasi panduan.