الرئيسية / برنامج MCP Tutorial / AppImage CLI

AppImage: solidcraft-cli & MCP

تحقق على صندوق Debian Linux ضد SolidCraftv0.30.0 (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كوسيلة مفيدة لتوفيرSolidCraft-cliمن الأقراص لا تزال بديلاً حقيقياً؛.tar.gz / .debقم بإدخال كلا الطرفين على الكمبيوتر مباشرة.
على هذه الصفحة أول إطلاق ما رأينا إصدار AppImage Extract (alternate) tar.gz و deb Snap FlatPak العملاء Config

إطلاق النار الأولى في~/.local/bin

وثائق MCP الرسمية: في أول إجراء، يكتب AppImageSolidCraft-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/binHomebrew 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 (واجهة رسومية) — لا تحوّل argv0 الـ AppImage إلى CLI. عند أول تشغيل يُكتب مشغّل في ~/.local/bin. بديل: استخرج solidcraft-cli أو استخدم deb/rpm/tar.gz.

استخراج AppImage (بديل) لـ MCP

  1. DownloadSolidCraft-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

Snap

الوثائق الرسمية: بعدsudo snap install SolidCraftيبدو أن CLI لا يزالPATHوهدفها مثلSolidCraft.cli(لاSolidCraft-cli) مثال :SolidCraft.cli --version / SolidCraft.cli mcp• الاستخدامSolidCraft.cliكما هو الحال مع عميل MCPcommandمعmcpمثل الأغنياء

FlatPak

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).

Claude Code، Claude Desktop، Cursor

ترغبSolidCraft-cliعلى اسمها عندما تكون علىPATH(AppImage launcher، deb، tarball).بعد ذلك، استخدم طريقًا كاملًا إلى CLI المختلط أو tarball.

كود كود

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

من أجل تثبيت tarball ، استخدم…/SolidCraft-0.30.0-linux-x86_64/bin/SolidCraft-cliعلى سبيل المثال، يمكنك استخدام SnapSolidCraft.cliعلى سبيل المثال، على Flatpak، استخدمflatpakمعrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

العودة إلى الرئيسيبرنامج MCP Tutorial · تثبيت المركبات.