mcp-vmanomaly

mcp-vmanomaly ماڈل کانٹیکسٹ پروٹوکول (MCP) سرور کا ایک اوپن سورس نفاذ ہے جو AI معاونین (جیسے Claude، Cursor، VS Code Copilot اور دیگر) کو VictoriaMetrics Anomaly Detection (vmanomaly) سے مربوط کرتا ہے۔ یہ ٹولز کا ایک مجموعہ فراہم کرتا ہے جو AI ایجنٹس کو REST API کے ذریعے چلنے والے vmanomaly انسٹینس کے ساتھ تعامل کرنے دیتا ہے، جس میں ہیلتھ مانیٹرنگ، ماڈل کی دریافت اور توثیق، YAML کنفیگریشن جنریشن، انوملی اسکور میٹرکس سے VMAlert رول جنریشن، ٹائم سیریز پروفائلنگ، مشترکہ آٹوٹیون ٹاسکس، اور فزی میچنگ کے ساتھ مکمل متن کی دستاویزات تلاش شامل ہے۔ سرور میں ایمبیڈڈ، تازہ ترین vmanomaly دستاویزات شامل ہیں تاکہ دستاویزات کی تلاش نیٹ ورک تک رسائی کے بغیر آف لائن کام کر سکے۔ یہ تین ٹرانسپورٹ موڈز کو سپورٹ کرتا ہے: stdio (ڈیفالٹ، مقامی سنگل صارف کے لیے)، Streamable HTTP (جو /mcp کو ظاہر کرتا ہے)، اور لیگیسی SSE ٹرانسپورٹ (جو /sse اور /message کو ظاہر کرتا ہے)۔ کنفیگریشن مکمل طور پر ماحولیاتی متغیرات کے ذریعے چلتی ہے، بشمول vmanomaly اینڈ پوائنٹ URL، بیئرر ٹوکن (یا ماؤنٹڈ سیکرٹس کے لیے ٹوکن فائل)، کسٹم HTTP ہیڈرز، درخواست کا ٹائم آؤٹ، ٹول الاؤ لسٹ/ڈینی لسٹ، وسائل کے ٹوگلز، ہارٹ بیٹ کا وقفہ، اور لاگ لیول/فائل۔ سرور آپریشنل مانیٹرنگ کے لیے Prometheus فارمیٹ /metrics، /health/liveness، اور /health/readiness اینڈ پوائنٹس بھی فراہم کرتا ہے۔ تنصیب کے اختیارات میں Go انسٹال، GitHub Releases سے پہلے سے تیار شدہ بائنریز (چیکسم اور بلڈ پروویننس تصدیق کے ساتھ)، ghcr.io سے Docker امیجز، اور سورس سے تعمیر شامل ہیں۔ کلائنٹ سیٹ اپ کی ہدایات Cursor، Claude Desktop، Claude Code، Visual Studio Code، Zed، JetBrains IDEs اور Windsurf کے لیے فراہم کی گئی ہیں، ہر ایک JSON کنفیگریشن ٹکڑوں کے ساتھ۔ ڈوکر پر مبنی کلائنٹ کنفیگریشن بھی شامل ہے ان ماحول کے لیے جہاں مقامی بائنری چلانا ناقابل عمل ہے۔ سیکیورٹی رہنمائی وسیع ہے: سرور درخواستوں کو پروسیس وائیڈ بیئرر ٹوکن کے ذریعے آگے بھیجتا ہے اور فی صارف شناخت یا ٹیننٹ تنہائی کو نافذ نہیں کرتا۔ دستاویزات مقامی سنگل صارف کے استعمال کے لیے stdio، ریموٹ HTTP/SSE رسائی کے لیے تصدیق شدہ TLS ریورس پراکسی (جیسے vmauth)، کم سے کم مراعات والی vmanomaly اسناد، اور ٹول الاؤ لسٹ/ڈینی لسٹ کے نفاذ کی تجویز کرتی ہیں۔ یہ واضح طور پر انتباہ کرتی ہے کہ ایک جامد MCP اسناد کے پیچھے متعدد ناقابل بھروسہ ڈومینز نہ رکھیں اور مشورہ دیتی ہے کہ ایک منطقی vmanomaly تنصیب کو ایک قابل اعتماد ڈومین سمجھا جائے۔ ٹول سیٹ زمرہ جات میں منظم ہے: ہیلتھ اور معلومات (4 ٹولز)، ماڈل کنفیگریشن (4 ٹولز)، کنفیگریشن توثیق (1 ٹول)، دستاویزات تلاش (1 ٹول)، مطابقت چیک (1 ٹول)، الرٹنگ رول جنریشن (1 ٹول)، اور تجزیہ اور آٹوٹیون (4 ٹولز)۔ آٹوٹیون ٹاسکس اصلاح کے بجٹ پیرامیٹرز (ٹرائلز، ٹائم آؤٹ، اعلی درجے کے Optuna پیرامیٹرز) قبول کرتے ہیں اور نمونہ شدہ ٹائم سیریز پر پروڈکشن کے لیے تیار ماڈل کنفیگریشنز کے لیے سفارشات واپس کرتے ہیں۔ سرور کو بنیادی ٹول سیٹ کے لیے vmanomaly 1.28.3+، ٹائم سیریز کی خصوصیات اور ٹاسک پر مبنی مشترکہ آٹوٹیون کے لیے 1.30.0+، اور نامزد کوری مشترکہ آٹوٹیون اور VMUI میں کوری پالیسی تجاویز کے لیے 1.30.5+ کی ضرورت ہوتی ہے۔ سورس سے تعمیر کے لیے Go 1.24+ ضروری ہے۔