mastyf.ai

أمان محيطي لذكائك الاصطناعي.

تطبيق وقت التشغيل، التحكم في السياسات، وسجل تدقيق كامل لكل إجراء من إجراءات الذكاء الاصطناعي.

الموقع · بداية سريعة · السياسة · لوحة التحكم · GitHub

المشكلة

يمكن لوكلاء الذكاء الاصطناعي قراءة ملفاتك، ودفع الكود، والاستعلام عن قواعد البيانات، وتنفيذ أوامر الشل، واستدعاء واجهات برمجة التطبيقات الخارجية. يفعلون ذلك بشكل مستقل، وبسرعة آلية.

الإجراءات الأمنية التقليدية لم تُصمم لذلك.

يعمل Mastyf.ai كطبقة أمان محيطية للذكاء الاصطناعي. يعترض كل استدعاء أداة، ويقيّمه مقابل سياساتك الأمنية باستخدام تحليل السرب متعدد الوكلاء، ويمنع الإجراءات الضارة أو غير المصرح بها قبل تنفيذها.

يتم فرض كل قرار، وتسجيله، ومراجعته.

ما يمنعه

بداية سريعة

بناء من المصدر

استنساخ المستودع وتشغيل سكريبت الإعداد.

المتطلبات:

• Git
• لينكس (سكريبت الإعداد يقوم بتثبيت Nix تلقائيًا إذا لزم الأمر)

git clone https://github.com/mastyf-ai/mastyf.ai.git
cd mastyf.ai
chmod +x setup.sh
./setup.sh

يقوم سكريبت الإعداد تلقائيًا بـ:

• تثبيت Nix (إذا لزم الأمر)
• تمكين Nix flakes
• إنشاء بيئة التطوير
• تثبيت جميع تبعيات المشروع
• إعادة بناء الحزم الأصلية
• بناء المشروع بأكمله
• إضافة اسم مستعار (alias) مناسب للـ mastyf في الشل

بمجرد اكتمال التثبيت، ابدأ تشغيل الوكيل ولوحة التحكم:

node dist/cli.js start

أو ببساطة استخدم الاسم المستعار بعد فتح طرفية جديدة:

mastyf

ستكون لوحة التحكم متاحة على:

• لوحة التحكم: http://localhost:4000

اختبار التثبيت

إذا كانت لوحة التحكم تعمل، تحقق من جسر HTTP:

curl -X POST http://localhost:4000/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'

لوحة التحكم

رؤية كاملة لكل إجراء يقوم به الذكاء الاصطناعي الخاص بك.

لا تعرض المنفذ 4000 للعامة دون تمكين مصادقة لوحة التحكم. التكوين المحلي الافتراضي يحتوي على DASHBOARD_AUTH_DISABLED=true.

كيف يعمل الفرض

يمر كل استدعاء أداة عبر ثلاث طبقات قبل الوصول إلى البنية التحتية الخاصة بك.

الطبقة 1 - كشف الأنماط فحص قائم على التعبيرات العادية للحقن، المسارات الخطرة، الأسرار المسربة، أوامر الشل، وحيل الترميز. يعمل بالميكروثانية دون تبعيات خارجية.

الطبقة 2 - التحقق من الصيغة يرفض الحمولات المشوهة، الوسائط كبيرة الحجم، وانتهاكات JSON-RPC قبل الوصول إلى تقييم السياسة.

الطبقة 3 - المراجعة الدلالية نموذج LLM محلي اختياري (Ollama) أو نموذج سحابي لتقييم الاستدعاءات الحدودية التي تتجاوز فحوصات الأنماط. يتراجع إلى الاستدلالات إذا لم يتم تكوين أي نموذج.

أي شيء يفشل يتم حظره. الأداة لا تعمل أبدًا. يتم تسجيل كل شيء.

السياسة

توجد قواعدك في default-policy.yaml. أنت تملكها. mastyf.ai يفرضها.

policy:
  mode: block
  default_action: pass
  unicode_strict: true
  rules:
    - name: block-sensitive-paths
      action: block
      argPatterns:
        - field: path
          patterns: ['^/etc/', '/\.ssh', '/\.aws/credentials']

    - name: rate-limit-tool-calls
      action: block
      maxCallsPerMinute: 120

    - name: block-shell-injection
      action: block
      patterns: ['rm\s+-rf', 'curl\s', 'wget\s', '`[^`]+`']

انشر بأمان مع ثلاثة أوضاع للفرض:

قوالب جاهزة لـ HIPAA و PCI-DSS و GxP و إقامة البيانات موجودة في policy-templates/.

البنية المعمارية

يدير mastyf.ai سربين منسقين. سرب CI يهاجم سياستك قبل شحن الكود. سرب وقت التشغيل يفرض ويتعلم من كل استدعاء أداة حية في الإنتاج. أربع حلقات تغذية راجعة تربطهم بحيث يصبح النظام أصعب في الاختراق بمرور الوقت.

flowchart TB

  AI["🤖 عملاء الذكاء الاصطناعي\nCursor · Claude Desktop · Cline"]

  subgraph CI["🔵 سرب CI (PR + ليلي)"]
    direction LR
    Scout["🔍 وكيل الاستطلاع\nSAST، التبعيات، فحص التكوين"]
    Corpus["📋 وكيل المجموعة\n228 أداة اختبارية"]
    Evasion["⚡ وكيل التهرب\n120+ استقصاء + توليد جديدة"]
    Parity["🔄 وكيل التطابق\nNode مقابل Python"]
    ProxyA["🖥️ وكيل الوكيل\nاختبارات MCP stdio الحية"]
    Report["📊 وكيل التقرير\nsecurity-swarm/latest.json"]
    Scout --> Corpus --> Evasion --> Parity --> ProxyA --> Report
  end

  subgraph Runtime["🟢 سرب وقت التشغيل (وكيل الإنتاج)"]
    direction LR
    BG["🛡️ BlockGuard\nسياسة متزامنة"]
    IL["📈 InstantLearner\nإحصائيات الحظر + اقتراحات"]
    SA["🧠 SemanticAuditor\nمعاينة LLM غير متزامنة، اختيارية"]
    PS["🔗 PatternSynthesizer\nاقتراحات مجمعة"]
    Cal["⚙️ المعاير\nتسميات + عتبات"]
    BG --> IL --> PS --> Cal
    BG --> SA --> PS
  end

  Tools["🗄️ أدوات MCP\nنظام الملفات · GitHub · قواعد البيانات · APIs"]

  AI -->|"كل استدعاء أداة"| BG
  BG -->|"✅ مسموح"| Tools
  Report -->|"🔁 الحلقة A: التجاوزات إلى المجموعة"| Corpus
  Cal -->|"🔁 الحلقة B: الحظر إلى القواعد"| BG
  Cal -->|"🔁 الحلقة C: التسميات إلى LLM"| SA
  Report -->|"🔁 الحلقة D: مقاييس CI أسبوعيًا"| Cal

  style CI fill:#EFF6FF,stroke:#3B82F6,stroke-width:2px,color:#1E3A5F
  style Runtime fill:#F0FDF4,stroke:#22C55E,stroke-width:2px,color:#14532D
  style Scout fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style Corpus fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style Evasion fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style Parity fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style ProxyA fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style Report fill:#DBEAFE,stroke:#3B82F6,color:#1E40AF
  style BG fill:#BBF7D0,stroke:#16A34A,color:#14532D
  style IL fill:#BBF7D0,stroke:#16A34A,color:#14532D
  style SA fill:#BBF7D0,stroke:#16A34A,color:#14532D
  style PS fill:#BBF7D0,stroke:#16A34A,color:#14532D
  style Cal fill:#BBF7D0,stroke:#16A34A,color:#14532D
  style AI fill:#FEF3C7,stroke:#F59E0B,stroke-width:2px,color:#78350F
  style Tools fill:#FEF3C7,stroke:#F59E0B,stroke-width:2px,color:#78350F

البوابات القانونية: 228/228 مجموعة، 0 تجاوز، تطابق 100%

سرب CI

يعمل في كل PR وليليًا. ستة وكلاء يعملون بالتسلسل، كل واحد يصلب ما وجده السابق.

سرب وقت التشغيل

يعمل داخل وكيل الإنتاج في كل استدعاء أداة.

حلقات التغذية الراجعة

يدعم الوكيل خمسة بوابات نقل: stdio، HTTP، SSE، HTTP قابل للتدفق، و WebSocket.

للنشر المؤسسي مع Redis و Postgres و Kubernetes، انظر docs/ENTERPRISE_DEPLOYMENT.md.

مختبر التهديد

يراقب مختبر التهديد الحركة الحية ويستخدم LLM محلي لاقتراح حالات اختبار هجوم جديدة عندما يكتشف أنماطًا مشبوهة. لا يتم تطبيق أي شيء تلقائيًا. تقوم بمراجعة والموافقة على كل اقتراح في لوحة التحكم قبل أن يصبح قاعدة.

تتغذى الاكتشافات المعتمدة مرة أخرى في مجموعة هجوم CI لاختبار الانحدار المستمر.

ollama serve
ollama pull qwen3:8b

export OLLAMA_BASE_URL=http://127.0.0.1:11434
export MASTYF_AI_LLM_PROVIDER=ollama
export MASTYF_AI_LLM_MODEL=qwen3:8b

pnpm dashboard:proxy

درجات ثقة حزمة MCP

قبل تثبيت أي خادم MCP من npm، تحقق من درجة الثقة الخاصة به على https://www.mastyf.ai/certified. تغطي الدرجات التعرض لـ CVE، مخاطر التصيد الاملائي (typo-squatting)، إشارات المشرف، وأنماط الهجوم المعروفة. مجاني، لا حاجة لحساب.

الأوامر الشائعة

استكشاف الأخطاء وإصلاحها

معرفة المزيد

• النشر المؤسسي (Redis, Postgres, Helm)
• خط الدفاع بالتفصيل
• سرب الأمن والاختراق الأحمر CI
• أمثلة تكامل MCP واقعية
• محرك الكشف الأساسي