首頁 / MCP 教程 / 影象 CLI

AppImage: solidcraft-cli & MCP

在 Debian Linux 盒子上對 SolidCraft 進行驗證v0.30.0 (SolidCraft-0.30.0-linux-x86_64.AppImage與匹配.tar.gz / .deb從GitHub 釋出首次執行發射器、Snap 和 Flatpak 命令名稱官方 MCP Docs.

簡短回答:執行 AppImage 一次後,它會寫出一個小小的SolidCraft-cli發射器進入~/.local/bin(因此,MCP客戶端可以按名稱呼叫它,如果該資料夾位於您的PATH) AppImage 入口點本身仍然是瓜 (SolidCraft)不接受mcp作為一個有用的 CLI 模式. 提取SolidCraft-cli從子仍然是一個有效的替代品;.tar.gz / .deb把兩種二進位制直接放到磁碟上。
在此頁面上 首批發射器 我們所看到的 AppImage 提取(替代) tar.gz 和 deb Snap的 飛行員 客戶端配置

初步發射器進入~/.local/bin

官方 MCP 檔案:在第一次執行時,AppImage 會寫出一個小SolidCraft-cli發射器進入~/.local/bin確保~/.local/bin在你的殼上PATH,重新啟動 MCP 客戶端,然後使用SolidCraft-cli mcp自 0.22.1 相匹配的 Windows 安裝程式和 macOS 應用程式(連結到/opt/homebrew/bin或/usr/local/bin),所以一個正常的包裝安裝放置SolidCraft-cli是PATHDeb、rpm 和 FreeBSD 已經安裝了 CLI。/usr/bin; Homebrew cask 將其放入PATH也是。

我們所看到的(真正的終端輸出)

直接執行 AppImage:

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

所以argv0 是桌面應用程式,而不是 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)

重新命名/重連結 AppImage 到SolidCraft-cli依然SolidCraft 0.30.0(GUI 二進位制) — 沒有 argv0 技巧將 AppImage 變成 CLI。~/.local/bin發射器,或下面的提取路徑。

AppImage 提取 (替代) 用於 MCP

  1. 下載SolidCraft-0.30.0-linux-x86_64.AppImage從解放.
  2. chmod +xAppImage(可選,如果您只提取)。
  3. 提取一次:./SolidCraft-…AppImage --appimage-extract
  4. 點 MCP 客戶端在絕對路徑…/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

喜歡 tar.gz 還是 deb? 兩艘船的 CLI

對於Linux.tar.gz佈局是bin/SolidCraft + bin/SolidCraft-cli(驗證).deb安裝相同的雙子/usr/bin/ (dpkg-deb -c對於僅限MCP的機器,tarball是最簡單的:

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的

官方檔案:後sudo snap install SolidCraft, CLI 停留PATH目的如SolidCraft.cli(不SolidCraft-cli)舉例:SolidCraft.cli --version / SolidCraft.cli mcp使用SolidCraft.cli如 MCP 客戶端command與mcp像阿爾格斯一樣。

飛行員

Flatpak 也將 CLI 關閉PATH標籤: 官方命令:

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

在 MCP 客戶端配置中,設定command兩flatpak和args兩["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](加上其他旗幟,如--allow-path).

克勞德·程式碼,克勞德·桌面,路由器

更喜歡SolidCraft-cli名稱當它在PATH(AppImage launcher, deb, tarball)否則使用到提取或 tarball CLI 的絕對路徑。

克勞德程式碼

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

或.mcp.json:

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

克勞德·桌面(Headless)

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

方程式

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

對於 tarball 安裝,使用…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cli使用Snap,使用SolidCraft.cli作為命令名稱. 對於 Flatpak,使用flatpak與run --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

回到主要MCP 教程 · 安裝指南.