AppImage: MCP용 `solidcraft-cli`는 어디에?

Debian Linux에서 SolidCraft v0.22.0 (solidcraft-0.22.0-linux-x86_64.AppImage 및 대응하는 .tar.gz / .deb를 GitHub Releases). 첫 실행 런처와 Snap·Flatpak 명령 이름은 공식 MCP 문서.

요약: AppImage를 한 번 실행하면 작은 solidcraft-cli 런처가 ~/.local/bin에 쓰입니다(그 폴더가 PATH에 있으면 MCP 클라이언트가 이름으로 호출). AppImage 진입점 자체는 여전히 GUI(solidcraft)이며 mcp를 유용한 CLI 모드로 받지 않습니다. squashfs에서 solidcraft-cli를 추출하는 것도 유효한 대안입니다. .tar.gz / .deb는 두 바이너리를 디스크에 바로 둡니다.

이 페이지에서 첫 실행 런처 확인한 내용 AppImage 추출(대안) tar.gz와 deb Snap Flatpak 클라이언트 설정

첫 실행 시 `~/.local/bin` 런처

공식 MCP 문서: 첫 실행 시 AppImage는 작은 solidcraft-cli 런처를 ~/.local/bin에 씁니다. ~/.local/bin이 셸 PATH에 있는지 확인하고 MCP 클라이언트를 다시 시작한 뒤 다른 패키지처럼 solidcraft-cli mcp를 쓰세요. deb·rpm·FreeBSD는 이미 /usr/bin에 CLI를 넣고, Windows 설치 프로그램과 Homebrew cask도 PATH에 둡니다. macOS 앱은 시작 시 /opt/homebrew/bin 또는 /usr/local/bin에 링크합니다.

확인한 내용(실제 터미널 출력)

AppImage를 직접 실행:

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

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

즉 argv0은 데스크톱 앱이지 CLI가 아닙니다. --appimage-extract 후:

$ ./solidcraft-0.22.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.22.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.22.0 (GUI 바이너리)로 보고됩니다 — argv0 트릭으로 CLI가 되지 않습니다. 첫 실행 ~/.local/bin 런처나 아래 추출 경로를 쓰세요.

MCP용 AppImage 추출(대안)

solidcraft-0.22.0-linux-x86_64.AppImage를 Releases에서 다운로드.
AppImage에 chmod +x(추출만 할 경우 선택).
한 번 추출: ./solidcraft-…AppImage --appimage-extract
MCP 클라이언트에 절대 경로 …/squashfs-root/usr/bin/solidcraft-cli 지정.

chmod +x solidcraft-0.22.0-linux-x86_64.AppImage
./solidcraft-0.22.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.22.0-linux-x86_64.tar.gz
./solidcraft-0.22.0-linux-x86_64/bin/solidcraft-cli --version
./solidcraft-0.22.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. MCP 클라이언트의 command로 solidcraft.cli, 인수로 mcp를 쓰세요.

Flatpak

Flatpak도 의도적으로 CLI를 PATH 밖에 둡니다. 공식 명령:

flatpak run --command=solidcraft-cli ai.storyteller.solidcraft mcp

MCP 클라이언트 설정에서 command를 flatpak, args를 ["run", "--command=solidcraft-cli", "ai.storyteller.solidcraft", "mcp"] (필요하면 --allow-path 등)로 둡니다.

Claude Code, Claude Desktop, Cursor

PATH에 있으면 이름으로 solidcraft-cli를 쓰세요(AppImage 런처, deb, tarball). 아니면 추출 또는 tarball CLI의 절대 경로를 쓰세요.

Claude Code

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

Claude Desktop(헤드리스)

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

tarball 설치에서는 …/solidcraft-0.22.0-linux-x86_64/bin/solidcraft-cli를 쓰세요. Snap은 명령 이름 solidcraft.cli. Flatpak은 flatpak에 run --command=solidcraft-cli ai.storyteller.solidcraft mcp.

돌아가기: MCP 튜토리얼 · 설치 가이드.