عن المشروع

mcp-vmanomaly هو تنفيذ مفتوح المصدر لخادم بروتوكول سياق النموذج (MCP) يربط مساعدي الذكاء الاصطناعي (مثل Claude وCursor وVS Code Copilot وغيرهم) بـ VictoriaMetrics Anomaly Detection (vmanomaly). يعرض مجموعة من الأدوات التي تتيح لوكلاء الذكاء الاصطناعي التفاعل مع مثيل vmanomaly قيد التشغيل عبر واجهة برمجة التطبيقات REST الخاصة به، ويغطي مراقبة الصحة، واكتشاف النماذج والتحقق منها، وتوليد تكوينات YAML، وتوليد قواعد VMAlert من مقاييس درجات الشذوذ، وتوصيف السلاسل الزمنية، ومهام الضبط التلقائي المشتركة، والبحث النصي الكامل في التوثيق مع المطابقة التقريبية. يأتي الخادم مزودًا بتوثيق vmanomaly المحدث والمدمج بحيث يعمل البحث في التوثيق دون اتصال بالإنترنت. يدعم ثلاثة أوضاع نقل: stdio (الافتراضي، للاستخدام المحلي أحادي المستخدم)، وStreamable HTTP (يكشف /mcp)، ونقل SSE القديم (يكشف /sse و/message). يتم التكوين بالكامل عبر متغيرات البيئة، بما في ذلك عنوان URL لنقطة نهاية vmanomaly، ورمز الحامل (أو ملف الرمز للأسرار المثبتة)، ورؤوس HTTP المخصصة، ومهلة الطلب، وقائمة السماح/الرفض للأدوات، ومفاتيح الموارد، وفاصل نبضات القلب، ومستوى/ملف السجل. يعرض الخادم أيضًا نقاط نهاية /metrics و/health/liveness و/health/readiness بتنسيق Prometheus للمراقبة التشغيلية. تشمل خيارات التثبيت تثبيت Go، والملفات الثنائية المبنية مسبقًا من إصدارات GitHub (مع التحقق من المجموع الاختباري وإثبات البناء)، وصور Docker من ghcr.io، والبناء من المصدر. يتم توفير تعليمات إعداد العميل لـ Cursor وClaude Desktop وClaude Code وVisual Studio Code وZed وJetBrains IDEs وWindsurf، مع مقاطع تكوين JSON. يتم أيضًا تضمين تكوين عميل قائم على Docker للبيئات التي يكون فيها تشغيل ملف ثنائي محلي غير عملي. الإرشادات الأمنية واسعة النطاق: يرسل الخادم الطلبات باستخدام رمز حامل على مستوى العملية ولا ينفذ هوية لكل مستخدم أو عزل مستأجر. توصي التوثيق بـ stdio للاستخدام المحلي أحادي المستخدم، ووكلاء TLS العكسيين المصادق عليهم (مثل vmauth) للوصول عن بُعد عبر HTTP/SSE، وبيانات اعتماد vmanomaly بأقل امتياز، وإنفاذ قائمة السماح/الرفض للأدوات. تحذر صراحةً من وضع مجالات متعددة غير موثوقة خلف بيانات اعتماد MCP ثابتة واحدة وتنصح بمعاملة تثبيت vmanomaly منطقي واحد كمجال موثوق واحد. يتم تنظيم مجموعة الأدوات في فئات: الصحة والمعلومات (4 أدوات)، تكوين النموذج (4 أدوات)، التحقق من التكوين (أداة واحدة)، البحث في التوثيق (أداة واحدة)، فحص التوافق (أداة واحدة)، توليد قواعد التنبيه (أداة واحدة)، والتحليل والضبط التلقائي (4 أدوات). تقبل مهام الضبط التلقائي معلمات ميزانية التحسين (التجارب، المهلة، معلمات Optuna المتقدمة) وتعيد توصيات لتكوينات نماذج جاهزة للإنتاج عبر سلاسل زمنية عينة. يتطلب الخادم vmanomaly 1.28.3+ لمجموعة الأدوات الأساسية، و1.30.0+ لخصائص السلاسل الزمنية والضبط التلقائي المشترك القائم على المهام، و1.30.5+ للضبط التلقائي المشترك للاستعلامات المسمّاة واقتراحات سياسات الاستعلام في VMUI. يتطلب البناء من المصدر Go 1.24+.