حزمة MCP المحلية
@dypai-ai/mcp (v1.6.17) هي حزمة Model Context Protocol المحلية. تعمل على جهازك، تقرأ ملفات مشروعك، وتسمح لوكيل الذكاء الاصطناعي بنشر تطبيقك إلى الإنتاج — شيء لا يستطيعه الخادم المستضاف، لأنه لا يرى نظام ملفاتك أبداً.
عادة لا تختار أحدهما أو الآخر: معظم الناس يتصلون بـ MCP البعيد للتعديل ويضيفون الحزمة المحلية للنشر.
البعيد مقابل المحلي
| MCP البعيد (السحابة) | المحلي — @dypai-ai/mcp | |
|---|---|---|
| أين يعمل | خادم HTTP مستضاف | على جهازك، عبر npx |
| الأدوات | 41 أداة موجّهة للوكيل | 28 أداة (الملف الافتراضي) |
| وصول نظام الملفات | لا شيء | يقرأ ملفات مشروعك |
| الأفضل لـ | التعديل داخل بيئة التطوير — الجداول وendpoints والمصادقة والسجلات | النشر والمقارنة ومزامنة كودك |
| الإعداد | الصق إعداد JSON | npx @dypai-ai/install |
الخادم البعيد هو ما يتصل به إعداد JSON لـ MCP (انظر تكامل MCP). تضيف الحزمة المحلية نشراً واعياً بنظام الملفات فوق ذلك — تحزّم كودك وتشحنه.
لماذا سطحان؟
يستطيع الخادم السحابي تعديل خلفيتك من أي مكان، لكنه لا يستطيع قراءة الملفات على حاسوبك. تملأ الحزمة المحلية تلك الفجوة: تدفع مشروعك المحلي إلى HeroMate وتنشره إلى الإنتاج.
التثبيت
تُثبَّت الحزمة المحلية بالطريقة نفسها لبقية MCP — عبر @dypai-ai/install:
npx @dypai-ai/install
يسمح المثبّت باختيار عميلك (Claude Code و Codex و Cursor و Windsurf و Antigravity وغيرهم) ويسجّلك للدخول لجلب رمز. بعد الضبط، يستطيع وكيل الذكاء الاصطناعي استدعاء الأدوات المحلية مباشرة. شغّل npx @dypai-ai/install --help لكل الخيارات.
الأدوات الـ 28 الافتراضية
يجمع الملف المحلي أدوات نشر واعية بنظام الملفات (فريدة للحزمة المحلية) مع مجموعة فرعية من الأدوات البعيدة المشتركة، حتى يتمكّن وكيلك من التعديل والشحن دون تبديل السياق.
النشر والمزامنة
هذه الأدوات التي تحتاج نظام ملفاتك — سبب وجود الحزمة المحلية:
| Parameter | Type | Description |
|---|---|---|
dypai_push | Tool | رفع التغييرات المحلية إلى مشروع HeroMate |
dypai_pull | Tool | سحب أحدث حالة للمشروع إلى ملفاتك المحلية |
dypai_diff | Tool | عرض ما يختلف بين ملفاتك المحلية والمشروع المنشور |
dypai_validate | Tool | التحقق من سير العمل المحلي والإعداد قبل النشر |
dypai_deploy_production | Tool | نشر تطبيقك إلى الإنتاج |
dypai_generate_types | Tool | توليد أنواع TypeScript لـ endpoints (endpoints.gen.ts) |
dypai_test_endpoint | Tool | تشغيل endpoint واحد محلياً للتحقق من عمله |
bulk_upsert | Tool | إدراج أو تحديث صفوف قاعدة بيانات كثيرة دفعة واحدة |
قاعدة البيانات والتخزين
| Parameter | Type | Description |
|---|---|---|
execute_sql | Tool | تشغيل استعلامات SQL على قاعدة بيانات مشروعك |
manage_database | Tool | فحص الجداول والأعمدة والترحيلات وإدارتها |
manage_storage | Tool | رفع الملفات في حاوية أو عرضها أو نقلها أو حذفها |
generate_image_asset | Tool | توليد صورة مُدارة (تُحسب كأرصدة ذكاء اصطناعي) وحفظها في التخزين |
المصادقة والجداول الزمنية وwebhooks
| Parameter | Type | Description |
|---|---|---|
manage_users | Tool | إنشاء المستخدمين أو عرضهم أو تحديثهم أو حذفهم |
manage_roles | Tool | إنشاء الأدوار المخصصة أو تحديثها أو حذفها |
manage_schedules | Tool | إنشاء التشغيلات المجدولة أو إيقافها أو استئنافها أو حذفها |
manage_webhooks | Tool | إنشاء مشغّلات webhook الواردة وإدارتها |
المشاريع والإصدارات
| Parameter | Type | Description |
|---|---|---|
list_projects | Tool | عرض المشاريع التي لديك وصول إليها |
get_project | Tool | الحصول على تفاصيل مشروع واحد |
create_project | Tool | إنشاء مشروع جديد |
get_app_credentials | Tool | عرض بيانات الاعتماد المضبوطة للمشروع |
get_endpoint_versions | Tool | عرض سجل إصدارات endpoint |
manage_domain | Tool | ربط نطاق مخصص أو فحصه |
التوثيق والبحث والأصول
| Parameter | Type | Description |
|---|---|---|
list_ai_models | Tool | عرض نماذج الذكاء الاصطناعي المتاحة لخطتك |
search_docs | Tool | البحث في توثيق HeroMate |
search_logs | Tool | البحث في سجلات التنفيذ والتطبيق |
search_flow_templates | Tool | العثور على قوالب سير عمل للأنماط الشائعة |
search_project_artifacts | Tool | البحث في أصول المشروع (ملفات، مخططات، ملخصات) |
manage_project_artifact | Tool | إنشاء أصل مشروع أو تحديثه |
متى تستخدم أيهما
استخدم MCP البعيد لـ…
تعديل خلفيتك من داخل بيئة التطوير — الجداول وendpoints والمصادقة والسجلات والتتبع. 41 أداة.
استخدم الحزمة المحلية لـ…
شحن الكود — الدفع/السحب، المقارنة مع الإنتاج، النشر، وتوليد الأنواع من ملفاتك. 28 أداة.
عملياً، يستخدم وكيلك الأدوات البعيدة للبناء والأدوات المحلية للنشر. أبقِ كليهما مضبوطاً ودعه يختار المناسب للمهمة.