首页 / 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 教程 · 安装指南.