דף הבית / MCP Tutorial תרגול / תגית: CLI

AppImage: solidcraft-cli & MCP

בדוק על תיבת Debian Linux נגד SolidCraftv0.30.0 (SolidCraft-0.30.0-linux-x86_64.AppImageתואם.tar.gz / .debמשחרור GitHubשם הפקודה: First Run Launcher, Snap and FlatpakMCP Docs רשמי.

תשובה קצרה :לאחר שתפעיל את AppImage פעם אחת, הוא כותבSolidCraft-cliLauncher לתוך~/.local/bin(לכן, הלקוחות של MCP יכולים לקרוא לזה בשם אם התיקיה הזאת נמצאתPATHנקודת הכניסה של AppImage עצמה היא עדייןגואי (SolidCraft) ואינו מקבלmcpתגיות: תגיות קשורות תגיות קשורות תגיות קשורותSolidCraft-cliמ- squashfs נשאר חלופה תקינה;.tar.gz / .debיש להניח את שני הכרטיסים ישירות על הדיסק.
בעמוד זה יציאה ראשונה מה שראינו תגית: AppImage Extract (alternate) ארכיון תגיות tar.gz & deb Snap פלטפורמה לקוח Config

הטריילר הראשון לניצחון~/.local/bin

מסמכי MCP רשמיים: בהפעלה הראשונה AppImage כותב מסמך קטןSolidCraft-cliLauncher לתוך~/.local/binוודאו~/.local/binהוא על הצל שלךPATHהפעל מחדש את ה- MCP Client ולאחר מכןSolidCraft-cli mcpכמו כל חבילה אחרת. מאז 0.22.1 אשר תואם את תוכנת ההתקנה של Windows ואת האפליקציה macOS (היא מחברת/opt/homebrew/binאו/usr/local/bin) כך חבילת התקנה רגילה מציעהSolidCraft-cliהואPATHDeb, rpm ו-FreeBSD כבר התקנו את CLI/usr/bin• Homebrew cask puts it onPATHגם כן

מה שראינו (יוצאת טרמינל אמיתית)

הפעל את 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 (alternate) עבור 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?

לינוקס.tar.gzLayout הואbin/SolidCraft + bin/SolidCraft-cliבודק – The.debלהוריד את אותו זוג מתחת/usr/bin/ (dpkg-deb -cעבור מכונות MCP-only, 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

תגית: Aftersudo snap install SolidCraftה-CLI נשארPATHלמטרה כמוSolidCraft.cli(לאSolidCraft-cli) דוגמה :SolidCraft.cli --version / SolidCraft.cli mcp• שימושSolidCraft.cliכמו הלקוח של MCPcommandעםmcpכמו הארגזים

פלטפורמה

Flatpak גם שומר את CLIPATHתגית: פקודה רשמית

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

ב- MCP Client Config, הגדרתcommand2flatpakוargs2["run", "--command=SolidCraft-cli", "io.tangencylabs.solidcraft", "mcp"](למעט דגלים נוספים כמו:--allow-path).

קלוד קוד, קלוד Desktop, Cursor

מעדיףSolidCraft-cliעל שמו כאשר הואPATH(AppImage launcher, deb, tarball). אחרת להשתמש במסלול מוחלט ל- extracted או 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"]
    }
  }
}

Claude Desktop (ללא ראש)

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

כדי להשתמש ב-TARBAL, השתמש…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliעבור Snap, השתמשSolidCraft.cliשם הפקודה עבור Flatpak, השתמשflatpakעםrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

חזרה לדף העיקריMCP Tutorial תרגול · מדריך ההתקנה.