Trang chủ / MCP hướng dẫn / AppImage CLI

AppImage: solidcraft-cli & MCP

Xác minh trên một hộp Debian Linux chống lại SolidCraft_Tok0 _ (SolidCraft-0.30.0-linux-x86_64.AppImagevà matching.tar.gz / .debtừGitHub phát hànhLần đầu tiên chạy launcher, Snap và Flatpak tên lệnh từMCP Docs chính thức.

Câu trả lời ngắn gọn:sau khi bạn chạy AppImage một lần, nó sẽ viết mộtSolidCraft-cliLauncher vào~/.local/bin(vì vậy, các máy khách MCP có thể gọi nó bằng tên nếu thư mục đó nằm trênPATH) Điểm nhập AppImage chính nó vẫn là điểmGui (SolidCraft(và không chấp nhậnmcpnhư một chế độ CLI hữu ích. trích xuấtSolidCraft-clitừ squashfs vẫn là một thay thế hợp lệ;.tar.gz / .debĐặt cả hai nhị phân trực tiếp vào đĩa.
Trên trang này Launcher đầu tiên Những gì chúng ta thấy AppImage Extract (Thay đổi) tar.gz và deb Snap FlatPack Khách hàng Config

Launcher đầu tiên vào~/.local/bin

Các tài liệu MCP chính thức: trong lần chạy đầu tiên, AppImage viết mộtSolidCraft-cliLauncher vào~/.local/binHãy chắc chắn~/.local/binTrên shell của bạnPATH, khởi động lại máy khách MCP, sau đó sử dụngSolidCraft-cli mcptừ 0.22.1 phù hợp với trình cài đặt Windows và ứng dụng macOS (mà liên kết đến/opt/homebrew/binhoặc/usr/local/bin, vì vậy một gói cài đặt bình thường đặtSolidCraft-cliCóPATHDeb, rpm và FreeBSD đã cài đặt CLI trong/usr/bin; Homebrew cask đặt nó trênPATHcũng vậy

Những gì chúng ta đã thấy (sản xuất cuối thực tế)

Chạy AppImage trực tiếp:

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

Vì vậy, argv0 là ứng dụng desktop, không phải 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 AppImage đểSolidCraft-cliVẫnSolidCraft 0.30.0(GUI nhị phân) – không có thủ thuật argv0 biến AppImage thành CLI.~/.local/binlauncher, hoặc đường trích xuất bên dưới.

Trích xuất AppImage (alternate) cho MCP

  1. Tải xuốngSolidCraft-0.30.0-linux-x86_64.AppImagetừGiải phóng.
  2. chmod +xAppImage (tùy chọn nếu bạn chỉ trích).
  3. Trích xuất 1 lần:./SolidCraft-…AppImage --appimage-extract
  4. Điểm khách hàng MCP trên con đường tuyệt đối…/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

Thích tar.gz hay deb? Cả hai tàu CLI

của Linux.tar.gzLayout làbin/SolidCraft + bin/SolidCraft-cli(đã xác minh) The.debcài đặt cùng một cặp dưới/usr/bin/ (dpkg-deb -cĐối với máy MCP-only, tarball là đơn giản nhất:

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

Docs chính thức: Aftersudo snap install SolidCraftCLI bị tắtPATHMục đích nhưSolidCraft.cli(Không phảiSolidCraft-cli) Ví dụ :SolidCraft.cli --version / SolidCraft.cli mcpSử dụngSolidCraft.cliĐối với khách hàng MCPcommandVớimcpGiống như Argos.

FlatPack

Flatpak cũng giữ CLI tắtPATHThiết kế: Lệnh chính thức:

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

Trong một MCP client config, thiết lậpcommandhaiflatpakvàargshai["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](và bất kỳ lá cờ nào khác như--allow-path).

Tác giả Claude Code, Claude Desktop, Cursor

Thích hơnSolidCraft-clibằng tên khi nó là trênPATH(AppImage launcher, deb, tarball). nếu không sử dụng một con đường tuyệt đối để trích xuất hoặc tarball CLI.

Mã Claude

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

hoặc.mcp.json:

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

Claude Desktop (không có đầu)

{
  "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"]
    }
  }
}

Đối với tarball cài đặt, sử dụng…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliĐối với Snap, sử dụngSolidCraft.clinhư tên lệnh. Đối với Flatpak, sử dụngflatpakVớirun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Trở lại chínhMCP hướng dẫn · Hướng dẫn cài đặt.