/ الدليل / الملعب / Frappe_Assistant_Core
← كل الخوادم ↗ GitHub
● مجتمع buildswithpaul ⚡ فوري

Frappe_Assistant_Core

بواسطة buildswithpaul · buildswithpaul/Frappe_Assistant_Core

اكشف عن مثيل ERPNext الخاص بك أمام Claude من خلال 21 أداة — المستندات والتقارير والتحليلات وحتى تنفيذ Python — مع OAuth والأذونات المستندة إلى الأدوار.

يتم تثبيت Frappe Assistant Core داخل مقاعد Frappe/ERPNext الخاصة بك ويتحدث MCP مع عملاء LLM. العمليات الأساسية للمستندات والبحث والإبلاغ وتنفيذ Python وإنشاء الرسوم البيانية كلها مقيدة بأذونات الأدوار الحالية في ERPNext، وتعني OAuth أن كل مستخدم يسجل الدخول تحت حسابه الخاص.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

frappe-assistant-core.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "frappe-assistant-core",
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "frappe-assistant-core": {
      "command": {
        "path": "uvx",
        "args": [
          "Frappe_Assistant_Core"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add frappe-assistant-core -- uvx Frappe_Assistant_Core

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Frappe_Assistant_Core

اطرح أسئلة العمل ضد ERPNext باللغة الإنجليزية العادية

👤 المؤسسون وقادة العمليات وفرق التمويل ⏱ ~15 min beginner

متى تستخدمه: تريد أرقام المبيعات والمخزون والحسابات المستحقة دون النقر عبر تقارير ERPNext أو انتظار المحلل.

المتطلبات الأساسية
  • موقع ERPNext مع تثبيت Frappe Assistant Core — bench get-app + bench install-app frappe_assistant_core
  • حساب مستخدم بأدوار القراءة المناسبة — استخدم تسجيل الدخول الخاص بك؛ تتبع الأذونات
الخطوات
  1. اتصل بـ Claude Desktop عبر OAuth
    Connect to my ERPNext MCP endpoint at https://erp.example.com/api/method/frappe_assistant_core.mcp✓ تم النسخ
    → يكتمل تسجيل دخول OAuth؛ يسرد Claude الأدوات المتاحة
  2. اطرح سؤال عمل
    What's my total sales this month broken down by customer group? Compare to last month.✓ تم النسخ
    → يقوم Claude بتشغيل أداة التقرير ويُرجع المقارنة
  3. التنقيب في الشذوذ
    Customer group 'Wholesale' dropped 40%. Show me the top 10 customers in that group and their YoY sales.✓ تم النسخ
    → قائمة مرتبة مع رؤية قابلة للتنفيذ

النتيجة: إجابات على أسئلة التمويل والعمليات في ثوانٍ دون مغادرة عميل الدردشة الخاص بك.

المزالق
  • يختلق Claude اسم Doctype لا يوجد في التخصيص الخاص بك — اطلب منه دائمًا إدراج Doctypes المتاحة أولاً، ثم المرجع بالاسم الدقيق
  • تقوم أداة تنفيذ Python بتشغيل كود غير معقم ضد قاعدة البيانات الخاصة بك — عطّل أداة execute_python_code للمستخدمين غير الإداريين عبر أذونات الأدوار
اجمعها مع: notion

إنشاء أو تحديث المستندات بكميات كبيرة من موجز

👤 استشاريو تنفيذ ERPNext والمهاجرون ⏱ ~20 min intermediate

متى تستخدمه: لديك جدول بيانات أو فقرة من البيانات تحتاج إلى الهبوط في ERPNext كمستندات متعددة (العناصر والعملاء والموردون).

المتطلبات الأساسية
  • إذن الكتابة على Doctype الهدف — من خلال الدور المعين لمستخدمك
الخطوات
  1. وصف ما يجب إنشاؤه
    I have these 15 new suppliers [paste table]. Create them as Supplier records with country, currency, and tax category set.✓ تم النسخ
    → يقترح Claude السجلات ويطلب التأكيد قبل الكتابة
  2. تأكيد ثم تنفيذ
    Looks good, proceed. Report any validation errors per row.✓ تم النسخ
    → تقرير إنشاء صف تلو الآخر مع أي أخطاء
  3. التحقق في ERPNext
    List the Suppliers I just created along with their creation date to confirm.✓ تم النسخ
    → قائمة تطابق من 15

النتيجة: دخول البيانات بالجملة مكتمل في دقائق بدون احتكاك أداة استيراد CSV.

المزالق
  • ينشئ Claude سجلات مكررة إذا لم يتم التحقق من المفاتيح الطبيعية — أخبره بالبحث عن السجلات الموجودة قبل كل إنشاء

اكشف عن منطق تطبيق Frappe المخصص الخاص بك كأدوات MCP

👤 مطورو Frappe/ERPNext ⏱ ~45 min advanced

متى تستخدمه: لديك تطبيق مخصص بمنطق نطاق (على سبيل المثال استهلاك القرض أو منفجر فاتورة المواد بالتصنيع) وتريد من LLMs استدعاءه مباشرة.

المتطلبات الأساسية
  • تطبيق Frappe مخصص — Standard bench new-app
الخطوات
  1. تسجيل أداة في hooks.py الخاص بتطبيقك
    Walk me through adding a custom MCP tool in my app acme_lending that computes loan amortization, based on the Frappe Assistant Core plugin spec.✓ تم النسخ
    → مقتطف hooks.py ملموس + وظيفة الأداة
  2. إعادة تحميل والتحقق
    How do I reload Frappe Assistant Core to pick up the new tool, and how do I confirm it shows up in Claude?✓ تم النسخ
    → bench restart + tool listing check

النتيجة: منطق النطاق الخاص بك قابل للاستدعاء الآن من أي عميل MCP، بدون الحاجة إلى إنشاء API منفصل.

المزالق
  • تسجل الأداة الحقول الحساسة في سجل التدقيق — ضع علامة على الحقول كـ no_copy أو غطِّ في استجابة الأداة

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

frappe-assistant-core + notion

تشغيل بيان الدخل والخسارة الشهري لـ ERPNext وإرسال ملخص إلى Notion للأسبوع القيادي

Run our monthly P&L report in ERPNext for last month, summarize top 3 variances vs plan, and create a Notion page in 'Finance Weekly'.✓ تم النسخ
frappe-assistant-core + filesystem

تصدير تقرير ERPNext إلى CSV/Markdown للمشاركة دون الاتصال

Run Sales by Customer report for Q1, save as /reports/sales-q1.csv.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
get_document doctype: str, name: str جلب مستند ERPNext محدد حسب المفتاح الأساسي 1 DB read
get_list doctype: str, filters?: obj, fields?: str[], limit?: int إدراج/البحث عن مستندات Doctype بالمرشحات 1 DB query
create_document doctype: str, data: obj إدراج مستند جديد — يحترم التحقق 1 DB write + hooks
update_document doctype, name, data تصحيح الحقول على مستند موجود 1 DB write
run_report report_name: str, filters?: obj تنفيذ تقرير Frappe Query/Script/Report Builder المحفوظ variable
execute_python_code code: str تشغيل Python تعسفي في سياق Frappe — للمسؤولين فقط، عطّل للمستخدمين العاديين unbounded
get_chart_data chart_name / config عرض مخطط لوحة معلومات Frappe كبيانات 1 aggregation query

التكلفة والحدود

تكلفة التشغيل

حصة API
محدود بسعة موقع ERPNext الخاص بك — تعامل مع مكالمات MCP مثل استدعاءات واجهة الويب
الرموز لكل استدعاء
استعلامات القائمة 500-3000 رموز؛ قراءات Doc الفردية 200-800
التكلفة المالية
مجاني — AGPL-3.0. التكلفة هي ما تدفعه لاستضافة ERPNext.
نصيحة
مرر دائمًا fields إلى get_list — قد يؤدي جلب فاتورة مبيعات كاملة مع جميع الجداول الفرعية إلى استهلاك 10 آلاف رمز لكل صف.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: أي أذونات أدوار يمتلكها المستخدم بالفعل في ERPNext
تخزين بيانات الاعتماد: رمز OAuth المخزن بواسطة عميل MCP؛ استدره في إعدادات مستخدم ERPNext
نقل البيانات الخارجي: مباشرة من موقع ERPNext الخاص بك إلى موفر LLM الذي تتصل به
لا تمنح أبدًا: System Manager إلى تطبيق OAuth إلا إذا كان مطلوبًا بصدق تفعيل `execute_python_code` للمستخدمين غير الإداريين

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

OAuth redirect fails / invalid_client

تأكد من تسجيل عميل OAuth في ERPNext > OAuth Client وأن redirect URIs تطابق callback عميل MCP الخاص بك بالضبط.

تحقق: تحقق من `bench log` وسجل OAuth Client
Tool says 'Permission denied' for a Doctype

المستخدم المسجل الدخول يفتقد دور القراءة/الكتابة. امنح الدور المناسب في أذونات المستخدم.

تحقق: جرب نفس العملية في واجهة الويب ERPNext
Custom plugin tool not appearing

قم بتشغيل bench restart وتأكد من تثبيت التطبيق على الموقع وأن hooks.py يكشف عن الأداة بشكل صحيح.

تحقق: اسرد الأدوات من Claude — يجب أن تكون أداتك المخصصة موجودة
ChatGPT custom connector rejects the endpoint

تتطلب موصلات ChatGPT المخصصة ChatGPT Plus مع Developer Mode. Claude Desktop أكثر تسامحًا.

البدائل

Frappe_Assistant_Core مقابل البدائل

البديلمتى تستخدمهاالمقايضة
REST API مباشرة + مُغلّاف MCP مخصصتحتاج فقط إلى 2-3 عمليات ولا تريد تثبيت تطبيق Frappeتقوم بإنشاء وصيانة الغلاف بنفسك
Odoo MCPأنت على Odoo بدلاً من ERPNextERP مختلف، Doctypes مختلفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills