AppImage: onde está o `solidcraft-cli` para MCP?

Verificado em uma máquina Debian Linux com o SolidCraft v0.16.2 (solidcraft-0.16.2-linux-x86_64.AppImage e os .tar.gz / .deb correspondentes, do GitHub Releases). Nome da CLI no Snap conforme o guia oficial Getting started.

Resposta curta: o ponto de entrada do AppImage é a interface gráfica (solidcraft). Ele não aceita mcp como modo de CLI útil. O binário do servidor MCP, solidcraft-cli, vem empacotado dentro do AppImage — extraia-o ou instale o .tar.gz / .deb, que colocam os dois binários no disco.

Nesta página O que observamos Extrair o AppImage tar.gz e deb Snap Configurações dos clientes

O que observamos (saída real do terminal)

Executando o AppImage diretamente:

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --version
solidcraft 0.16.2

$ ./solidcraft-0.16.2-linux-x86_64.AppImage --help
usage: solidcraft [--control PORT] [--sample] [--crash-log] [--safe-mode] [design.solidcraft | part.step]

Ou seja, o argv0 é o aplicativo desktop, não a CLI. Depois de --appimage-extract:

$ ./solidcraft-0.16.2-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.16.2

$ ./squashfs-root/usr/bin/solidcraft-cli mcp
solidcraft mcp: files limited to …/recovery, /tmp/solidcraft-mcp-… and the open design's folder …
# (servidor MCP via stdio iniciado; Ctrl-C / feche o stdin para parar)

Renomear o AppImage para solidcraft-cli (ou criar um link simbólico com esse nome) continuou mostrando solidcraft 0.16.2 (o binário da interface gráfica) — não há truque com argv0 que transforme o AppImage na CLI.

Fluxo recomendado com AppImage para MCP

Baixe o solidcraft-0.16.2-linux-x86_64.AppImage em Releases.
Rode chmod +x no AppImage (opcional se você só for extrair).
Extraia uma vez: ./solidcraft-…AppImage --appimage-extract
Aponte os clientes MCP para o caminho absoluto …/squashfs-root/usr/bin/solidcraft-cli.

chmod +x solidcraft-0.16.2-linux-x86_64.AppImage
./solidcraft-0.16.2-linux-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/solidcraft-cli mcp

Prefere tar.gz ou deb? Os dois trazem a CLI

O .tar.gz para Linux contém bin/solidcraft + bin/solidcraft-cli (verificado). O .deb instala o mesmo par em /usr/bin/ (dpkg-deb -c lista os dois). Em máquinas só para MCP, o tarball é o caminho mais simples:

tar -xzf solidcraft-0.16.2-linux-x86_64.tar.gz
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli --version
./solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli mcp

Snap

Documentação oficial: depois de sudo snap install solidcraft, a CLI se chama solidcraft.cli (e não solidcraft-cli). Exemplo: solidcraft.cli --version / solidcraft.cli mcp.

Claude Code, Claude Desktop, Cursor

Troque o caminho do comando pela CLI extraída ou do tarball. Caminhos absolutos evitam problemas com o PATH.

Claude Code

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

Ou no .mcp.json:

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

Claude Desktop (headless)

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

Em instalações pelo tarball, use …/solidcraft-0.16.2-linux-x86_64/bin/solidcraft-cli. No Snap, use solidcraft.cli como nome do comando.

Voltar ao tutorial de MCP · guia de instalação.