Головна / MCP туториал / AppImage CLI

AppImage: solidcraft-cli & MCP

Перевірка на коробці Debian Linux проти SolidCraft• Токіо (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 Снап Флатпак Клієнт конфігурує

Перший запуск в~/.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

Лінукс.tar.gzLayout є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

Снап

Офіційні документи: післяsudo snap install SolidCraftКлієнт залишається позаPATHЗ метою якSolidCraft.cli(НіSolidCraft-cli) Приклад :SolidCraft.cli --version / SolidCraft.cli mcpВикористовуйтеSolidCraft.cliЯк працює клієнт MCPcommandз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"]
    }
  }
}

Клод Десктоп (без голови)

{
  "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 туториал · Інсталяційне керівництво.