इस प्रोजेक्ट के बारे में

mcp-vmanomaly एक ओपन-सोर्स Model Context Protocol (MCP) सर्वर कार्यान्वयन है जो AI सहायकों (जैसे क्लॉड, कर्सर, VS Code Copilot, आदि) को VictoriaMetrics Anomaly Detection (vmanomaly) से जोड़ता है। यह उपकरणों का एक सेट प्रदान करता है जो AI एजेंटों को चल रहे vmanomaly इंस्टेंस के साथ उसके REST API के माध्यम से इंटरैक्ट करने की अनुमति देता है, जिसमें स्वास्थ्य निगरानी, मॉडल खोज और सत्यापन, YAML कॉन्फ़िगरेशन जनरेशन, एनोमली स्कोर मेट्रिक्स से VMAlert नियम निर्माण, टाइम-सीरीज़ प्रोफाइलिंग, साझा ऑटोट्यून कार्य, और फ़ज़ी मैचिंग के साथ फुल-टेक्स्ट दस्तावेज़ खोज शामिल है। सर्वर में एम्बेडेड, अप-टू-डेट vmanomaly दस्तावेज़ शामिल है ताकि दस्तावेज़ खोज नेटवर्क एक्सेस के बिना ऑफ़लाइन काम कर सके। यह तीन ट्रांसपोर्ट मोड का समर्थन करता है: stdio (डिफ़ॉल्ट, स्थानीय एकल-उपयोगकर्ता के लिए), Streamable HTTP (/mcp उजागर करता है), और लिगेसी SSE ट्रांसपोर्ट (/sse और /message उजागर करता है)। कॉन्फ़िगरेशन पूरी तरह से पर्यावरण चर द्वारा संचालित है, जिसमें vmanomaly एंडपॉइंट URL, बेयरर टोकन (या माउंटेड सीक्रेट्स के लिए टोकन फ़ाइल), कस्टम HTTP हेडर, अनुरोध टाइमआउट, टूल अनुमत सूची/अस्वीकृति सूची, संसाधन टॉगल, हार्टबीट अंतराल, और लॉग स्तर/फ़ाइल शामिल है। सर्वर परिचालन निगरानी के लिए Prometheus-प्रारूप /metrics, /health/liveness, और /health/readiness एंडपॉइंट भी उजागर करता है। स्थापना विकल्पों में Go install, GitHub Releases से प्री-बिल्ट बाइनरीज़ (चेकसम और बिल्ड-प्रोवेंस प्रमाणीकरण सत्यापन के साथ), ghcr.io से Docker इमेज, और स्रोत से निर्माण शामिल है। क्लाइंट सेटअप निर्देश Cursor, Claude Desktop, Claude Code, Visual Studio Code, Zed, JetBrains IDEs, और Windsurf के लिए दिए गए हैं, प्रत्येक के लिए JSON कॉन्फ़िगरेशन स्निपेट के साथ। स्थानीय बाइनरी चलाना अव्यावहारिक वातावरणों के लिए Docker-आधारित क्लाइंट कॉन्फ़िगरेशन भी शामिल है। सुरक्षा मार्गदर्शन व्यापक है: सर्वर प्रक्रिया-व्यापी बेयरर टोकन का उपयोग करके अनुरोध अग्रेषित करता है और प्रति-उपयोगकर्ता पहचान या टेनेंट आइसोलेशन लागू नहीं करता है। दस्तावेज़ स्थानीय एकल-उपयोगकर्ता के लिए 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+ आवश्यक है।