Snyk Agent Scan

اكتشف وافحص مكوّنات الوكلاء على جهازك بحثًا عن حقن الموجّهات
والثغرات الأمنية (بما في ذلك الوكلاء وخوادم MCP والمهارات).

ملاحظة: لا ننشر حزمة npm لـ Agent Scan. ثبّته عبر uvx أو كـملف تنفيذي مستقل.

ملاحظة: مخرجات سطر الأوامر تجريبية وقابلة للتغيير

Agent Scan v0.5.x (مخطط لإيقافه)

المخرجات الخام لسطر الأوامر هذا — بما في ذلك رموز المشكلات وأسماء الحقول وتسميات الخطورة وبنية الاستجابة — تجريبية وقد تتغير دون إشعار بين الإصدارات. لا نوصي ببناء سير عمل إنتاجي يعتمد على حقول مخرجات أو رموز مشكلات محددة في سطر الأوامر.

Agent Scan v0.6 وما بعده

المخرجات الخام لسطر الأوامر هذا — بما في ذلك أسماء مؤشرات المخاطر والدرجات وأسماء الحقول وبنية الاستجابة — تجريبية وقد تتغير دون إشعار بين الإصدارات. لا نوصي ببناء سير عمل إنتاجي يعتمد على حقول مخرجات أو أسماء مخاطر محددة في سطر الأوامر.

إذا كنت عميلًا مؤسسيًا تستخدم Snyk لإدارة مخاطر أمان الوكلاء على نطاق واسع، فقد لا تعكس مخرجات سطر الأوامر ما يُرسل ويُعرض في منصة Evo. التكامل الأساسي والاكتشاف وتقييم المخاطر التي تشغّل عمليات النشر المؤسسية مستقرة ومدعومة — وسيُبلَّغ عن أي تغييرات وفقًا لممارسات منتجات Snyk القياسية. تواصل مع فريق حسابك للحصول على إرشادات النشر.

جديد اقرأ تقريرنا التقني حول التهديدات الناشئة في منظومة مهارات الوكلاء المنشور مع Agent Scan 0.4، والذي يضيف دعمًا لفحص مهارات الوكلاء.

مخرجات Agent Scan v0.5.x

[!WARNING] يستخدم Agent Scan v0.5.x مخرجات برموز المشكلات. من المخطط إيقاف خط سطر الأوامر هذا.

مخرجات Agent Scan v0.6 وما بعده

يساعدك Agent Scan على اكتشاف جميع مكوّنات الوكلاء المثبّتة لديك (بيئات التشغيل وخوادم MCP والمهارات) ويفحصها بحثًا عن التهديدات الشائعة مثل حقن الموجّهات أو التعامل مع البيانات الحساسة أو الحمولات الخبيثة المخفية في اللغة الطبيعية. تجاهل التحليل على المهارات باستخدام --no-skills.

تحذير أمني

⚠️ مهم: قد يؤدي فحص إعدادات MCP إلى تنفيذ أوامر أو إجراء طلبات شبكة صادرة.

لاسترداد أوصاف الأدوات، يشغّل Agent Scan خوادم MCP من نوع stdio عبر تنفيذ الأوامر الموجودة في الإعدادات، ويتصل بعناوين URL لخوادم MCP البعيدة المُهيّأة باستخدام ترويساتها المُهيّأة.

التوصيات:

• شغّل عمليات الفحص داخل بيئة معزولة (sandbox) (حاوية Docker، أو جهاز ظاهري، أو بيئة قابلة للتخلص منها) عند تقييم إعدادات MCP غير موثوقة أو تابعة لجهات خارجية
• راجع مطالبة الموافقة بعناية أثناء عمليات الفحص التفاعلية؛ فهي تعرض الأمر أو عنوان URL البعيد لكل خادم
• استخدم --dangerously-run-mcp-servers فقط في البيئات الموثوقة التي تحققت فيها من جميع أوامر خوادم MCP وعناوين URL البعيدة

ترفض طلبات MCP البعيدة الوجهات التي تُحلّ إلى عناوين link-local أو نقاط نهاية معروفة للبيانات الوصفية السحابية (169.254.0.0/16، fe80::/10، fd00:ec2::254، و100.100.100.200). تظل عناوين loopback والعناوين الخاصة مسموحًا بها لخوادم MCP المحلية والداخلية. لا تُتبَّع عمليات إعادة التوجيه HTTP. يُتحقق من DNS قبل كل طلب، لكن إعادة الحل عند وقت الاتصال تترك نافذة لإعادة ربط DNS (DNS-rebinding).

افتراضيًا، يتطلب Agent Scan موافقة صريحة من المستخدم (y/n) قبل الاتصال بكل خادم MCP مكتشف أثناء التشغيل التفاعلي في المقدمة. تستمر عمليات الفحص الخلفية وعمليات الفحص بمفتاح الدفع في فحص الخوادم البعيدة تلقائيًا لتغطية الأسطول، لكنها لا تشغّل خوادم stdio ما لم يتم تعيين --dangerously-run-mcp-servers.

البدء السريع

اختر إحدى طريقتين لتشغيل Agent Scan:

1. تشغيل حزمة Python باستخدام uvx وفق التعليمات أدناه.
2. تنزيل ملف ثنائي مستقل لمنصتك من GitHub Releases. تتضمن الإصدارات أيضًا SBOM، والمجاميع الاختبارية (checksums)، والمجاميع الاختبارية الموقّعة، وأرشيفات الشيفرة المصدرية.

قبل استخدام أي من الخيارين:

1. سجّل في Snyk واحصل على رمز API من https://app.snyk.io/account (API Token → KEY → انقر للعرض).
2. عيّن الرمز كمتغير بيئة قبل تشغيل أي فحص:

   export SNYK_TOKEN=your-api-token-here
   

التشغيل باستخدام uvx

تأكد من تثبيت uv على نظامك. اختر التعليمات الخاصة بإصدار CLI لديك.

Agent Scan v0.5.x

تثبّت الأمثلة الإصدار v0.5.17 كإصدار محدّد من سلسلة v0.5.x:

# Scan the whole machine
uvx [email protected]

# Scan a specific MCP configuration
uvx [email protected] ~/.vscode/mcp.json

# Scan a single agent skill
uvx [email protected] ~/path/to/my/SKILL.md

# Scan all Claude skills
uvx [email protected] ~/.claude/skills

[!WARNING] يستخدم الإصدار v0.5.x مخرجات issue-code وواجهة تحليل 2025-09-02. من المقرر إيقاف خط CLI هذا.

Agent Scan v0.6 والإصدارات اللاحقة

# Scan the whole machine
uvx snyk-agent-scan@latest

# Scan a specific MCP configuration
uvx snyk-agent-scan@latest ~/.vscode/mcp.json

# Scan a single agent skill
uvx snyk-agent-scan@latest ~/path/to/my/SKILL.md

# Scan all Claude skills
uvx snyk-agent-scan@latest ~/.claude/skills

v0.6 والإصدارات اللاحقة تستخدم المخرجات القائمة على المخاطر وواجهة تحليل 2026-07-10.

كلا الإصدارين يفحصان خوادم MCP والأدوات والمطالبات والموارد والمهارات، ويكتشفان تلقائيًا إعدادات الوكلاء المدعومة مثل Claude Code/Desktop وCursor وGemini CLI وWindsurf.

التشغيل باستخدام ملف ثنائي مستقل

نزّل الملف الثنائي الخاص بنظام التشغيل والبنية المعمارية لديك من أحدث إصدار على GitHub. كما توفر صفحة الإصدار ملف SBOM (sbom-<version>.json) وملفات التحقق من المجموع الاختباري وأرشيفات الشيفرة المصدرية التي ينشئها GitHub. راجع التحقق من الملفات الثنائية المستقلة للتحقق من التنزيل.

أبرز الميزات

• الاكتشاف التلقائي لإعدادات MCP وأدوات الوكلاء والمهارات
• فحص Claude وCursor وGitHub Copilot وWindsurf وGemini CLI وAmp وAmazon Q ووكلاء آخرين.

Agent Scan v0.5.x

• يكتشف أكثر من 15 خطرًا أمنيًا متميزًا عبر خوادم MCP ومهارات الوكلاء:
  • MCP: حقن المطالبات، تسميم الأدوات، تظليل الأدوات، التدفقات السامة
  • المهارات: حقن المطالبات، حمولات البرمجيات الخبيثة، محتوى غير موثوق، التعامل مع بيانات الاعتماد، أسرار مضمّنة في الشيفرة

Agent Scan v0.6 والإصدارات اللاحقة