# Foxmayn Frappe CLI: سطر أوامر وخادم MCP لـ Frappe

> سطر أوامر وخادم MCP وتطبيق سطح مكتب لمواقع Frappe وERPNext. اعملوا على المستندات من الطرفية، أو اتركوا ذلك لمساعد ذكاء اصطناعي.

Updated: 2026-10-27

- **التفاصيل:** Foxmayn Frappe CLI (ffc)
- **آخر إصدار:** v1.21.1 (2026-10-25) https://github.com/nasroykh/foxmayn_frappe_cli/releases/tag/v1.21.1
- **الرخصة:** MIT
- **لغة البرمجة:** Go
- **روابط:** https://github.com/nasroykh/foxmayn_frappe_cli

ليس مشروعاً رسمياً من Frappe. ولا ارتباط له بشركة Frappe Technologies.

## ماذا يفعل

يتصل `ffc` بموقع Frappe أو ERPNext عبر واجهة REST API. يمكنكم قراءة المستندات وإنشاؤها وتحديثها واعتمادها وإلغاؤها من الطرفية. هو للمسؤولين والمطورين ولكل من يريد أن يعمل مساعد ذكاء اصطناعي مثل Claude على نظام ERP لديه.

يعمل دائماً بصلاحيات مستخدم Frappe الذي سجّلتم الدخول به. ولا يستطيع أن يفعل أكثر مما يستطيعه هذا المستخدم في Desk.

## الميزات

- **المستندات:** `list-docs` و`get-doc` و`create-doc` و`update-doc` و`submit-doc` و`cancel-doc` و`bulk-update`.
- **سير العمل:** `workflow apply`.
- **البحث والطباعة:** `search` و`pdf`.
- **الملفات:** `files upload` و`files download`.
- **الإعداد:** `init` ينشئ ملف تعريف للموقع، و`whoami` يعرض من سجّلتم الدخول باسمه.
- **أعلام الأمان:** `--dry-run` يعرض ما كان سيتغيّر. و`--read-only` يمنع كل كتابة.
- **خادم MCP:** `ffc mcp` يشغّل خادم Model Context Protocol لمساعدي الذكاء الاصطناعي. ويُوزَّع أيضاً كحزمة `.mcpb` ومدرج في سجل MCP باسم `io.github.nasroykh/ffc`. استعملوا `ffc mcp install` و`ffc mcp uninstall` لإعداد العملاء المدعومين.
- **تطبيق سطح المكتب:** `ffc desktop install` و`ffc desktop status`. تطبيق سطح المكتب يعمل على Windows وmacOS. وهو إصدار تجريبي مسبق (0.11.x) وغير موقَّع.
- **التحديثات:** `ffc update`.

## التثبيت

Linux وmacOS:

```bash
curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.ps1 | iex
```

Homebrew:

```bash
brew install nasroykh/tap/ffc
```

Scoop:

```bash
scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket
scoop install ffc
```

ثم اربطوا موقعكم الأول:

```bash
ffc init
ffc whoami
```

تغطي الإصدارات Linux وmacOS (amd64 وarm64) وWindows (amd64 وarm64). مجاميع التحقق موقَّعة بـ Ed25519، ويتحقق منها سكربت التثبيت عند وجود OpenSSL 3. ويشغّل CI الأمرين `go vet` و`go test` قبل كل إصدار، ويصدر سير عمل الإصدار شهادة منشأ (provenance attestation).

## لماذا بنيناه

نعمل على مواقع Frappe كل يوم. التنقل في Desk لفحص سجل واحد أو تحديث خمسين سجلاً بطيء. وسطر الأوامر القابل للبرمجة أسرع، ويندرج في سكربتات الصدفة ومهام CI.

يجعل مساعدو الذكاء الاصطناعي هذا أنفع، وأخطر أيضاً. يمنحهم خادم MCP وصولاً حقيقياً إلى الموقع، لكن بصلاحيات مستخدم واحد فقط، ويتيح وضع `--read-only` أن تبدأوا بالقراءة وحدها. نستعمل `ffc` في [عملنا بالذكاء الاصطناعي على ERPNext](https://foxmayn.com/ar/services).

الأداة مكتوبة بلغة Go ومنشورة برخصة MIT. اطلعوا على الشيفرة المصدرية والإصدارات والمشكلات على [GitHub](https://github.com/nasroykh/foxmayn_frappe_cli). أدوات ذات صلة: [Foxmayn Frappe Manager](https://foxmayn.com/ar/open-source/ffm) للبيئات (benches) و[Foxmayn Frappe Types](https://foxmayn.com/ar/open-source/fft) لـ TypeScript.

---
تواصل معنا: foxmayn@protonmail.com · https://foxmayn.com/ar#contact
HTML: https://foxmayn.com/ar/open-source/ffc · [en](https://foxmayn.com/en/open-source/ffc.md) · [fr](https://foxmayn.com/fr/open-source/ffc.md)