Inicio / Tutoriais do MCP / Aplicacións CLI

AppImage: solidcraft-cli & MCP

Verificado nunha caixa de Debian Linux contra SolidCraft_Tok0__ (SolidCraft-0.30.0-linux-x86_64.AppImageCoincidindo.tar.gz / .debdeGitHub PublicaciónsPrimeiro lanzador, Snap e Flatpak nomes de comandos a partir doPáxina oficial do MCP Docs.

Resposta curta:despois de executar a AppImage unha vez, escribe unha pequenaSolidCraft-cliLanzador en~/.local/bin(de xeito que os clientes de MCP poden chamalo por nome se esa carpeta está no seuPATHO punto de entrada de AppImage aínda é oGuía (SolidCrafte non aceptamcpcomo un modo CLI útil. extracciónSolidCraft-clidos squashfs permanece unha alternativa válida;.tar.gz / .debPoñer os dous binarios directamente no disco.
Nesta páxina Primeiro lanzador O que vimos Extracto de AppImage (alternativo) tar.gz e deb Snap FlatPac Cliente Configuración

Primeiro lanzamento en~/.local/bin

Doces oficiais de MCP: na primeira execución, a AppImage escribe unha pequenaSolidCraft-cliLanzador en~/.local/binAsegúrese~/.local/binEstá no teu shellPATH, reiniciar o cliente MCP, a continuación, useSolidCraft-cli mcpcomo calquera outro paquete. Desde 0.22.1 que coincide co instalador de Windows e a aplicación macOS (que/opt/homebrew/binou/usr/local/bin), polo que un paquete normal instalaSolidCraft-cliquePATHDeb, rpm e FreeBSD xa instalaron o CLI en/usr/binHomebrew cask poñer enPATHTamén o

O que vimos (output terminal real)

Executar a AppImage directamente:

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

Así que argv0 é a aplicación de escritorio, non o 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)

Renomear/symlinkar a AppImage paraSolidCraft-cliaíndaSolidCraft 0.30.0(GUI binario) — non hai truco argv0 que converta a AppImage no CLI. Prefire o primeiro executado~/.local/bino lanzador, ou o camiño de extracción de abaixo.

Extracto de AppImage (alternativo) para MCP

  1. DescargarSolidCraft-0.30.0-linux-x86_64.AppImagedeLiberacións.
  2. chmod +xo AppImage (opcional se só extrae).
  3. Extraer unha vez:./SolidCraft-…AppImage --appimage-extract
  4. Punto MCP clientes no camiño absoluto…/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

Preferir tar.gz ou deb? Ambos os barcos o CLI

O Linux.tar.gzO layout ébin/SolidCraft + bin/SolidCraft-cli(controlado) O.debinstalar o mesmo par baixo/usr/bin/ (dpkg-deb -cPara máquinas só MCP, o tarball é o máis sinxelo:

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

Documentos oficiais: despoissudo snap install SolidCraftO CLI queda afastadoPATHO obxectivo comoSolidCraft.cli(Non seSolidCraft-cli• Exemplo:SolidCraft.cli --version / SolidCraft.cli mcpUtilizaciónSolidCraft.clicomo o cliente do MCPcommandconmcpcomo os argos.

FlatPac

Flatpak tamén mantén o CLI fóraPATHpor deseño. comando oficial:

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

Unha vez configurado o cliente MCP, ocommandDúasflatpakeargsDúas["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](Algunhas bandeiras adicionais como--allow-path).

Categoría: Claude Code, Claude Desktop

PrefiroSolidCraft-clipolo nome cando está enPATH(AppImage launcher, deb, tarball). se non, use un camiño absoluto para o CLI extraído ou tarball.

Claude Código

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

ou.mcp.json:

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

Claude Desktop (← ligazóns editar)

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

Para as instalacións de tarball, use…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliEn lugar de. para Snap, useSolidCraft.clicomo o nome de comando. Para Flatpak, useflatpakconrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Volver ao principalTutoriais do MCP · Instalacións Guía.