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

Grafana MCP सर्वर एक Model Context Protocol (MCP) सर्वर है जो Claude Desktop या Cursor जैसे MCP क्लाइंट्स को Grafana इंस्टेंस और उसके आसपास के इकोसिस्टम से जोड़ता है। पूर्ण कार्यक्षमता के लिए इसके लिए Grafana 9.0 या बाद का संस्करण आवश्यक है, क्योंकि कुछ डेटासोर्स ऑपरेशन नए API एंडपॉइंट्स पर निर्भर करते हैं। सेटअप MCP क्लाइंट कॉन्फ़िगरेशन में एक एंट्री जोड़कर किया जाता है, आमतौर पर सर्वर को uvx के माध्यम से चलाया जाता है, जिसमें पर्यावरण में GRAFANA_URL और एक सर्विस अकाउंट टोकन होता है। Docker, बाइनरी और Helm इंस्टॉलेशन विकल्प भी प्रलेखित हैं। क्षमताओं को टूल श्रेणियों में समूहित किया गया है, और टूल सूची कॉन्फ़िगर करने योग्य है ताकि अप्रयुक्त कार्यक्षमता को अक्षम किया जा सके और कॉन्टेक्स्ट विंडो स्थान बचाया जा सके। श्रेणियों को --disable-oncall या --disable-navigation जैसे फ़्लैग्स के साथ बंद किया जा सकता है, और कई श्रेणियाँ डिफ़ॉल्ट रूप से अक्षम हैं और उन्हें --enabled-tools के माध्यम से सक्षम करना आवश्यक है। डैशबोर्ड टूल्स में शीर्षक, फ़ोल्डर UID, टैग या स्टार्ड स्थिति के आधार पर खोज; UID या सहेजे गए संस्करण के आधार पर डैशबोर्ड प्राप्त करना; संस्करणों की सूची बनाना; संक्षिप्त सारांश प्राप्त करना; JSONPath के माध्यम से भागों को निकालना; डैशबोर्ड बनाना, अपडेट करना और पैच करना; और डेटासोर्स जानकारी के साथ पैनल क्वेरीज़ पढ़ना शामिल है। README में उल्लेख किया गया है कि पूर्ण डैशबोर्ड JSON महत्वपूर्ण कॉन्टेक्स्ट विंडो स्थान ले सकता है और इसके बजाय सारांश या JSONPath टूल्स का उपयोग करने का सुझाव देता है। डेटासोर्स और क्वेरीिंग समर्थन में डेटासोर्स की सूची बनाना और निरीक्षण करना (Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena), PromQL इंस्टेंट और रेंज क्वेरीज़ के साथ-साथ मीट्रिक मेटाडेटा और हिस्टोग्राम परसेंटाइल्स, लेबल और पैटर्न डिस्कवरी के साथ LogQL लॉग और मीट्रिक क्वेरीज़, InfluxQL या Flux के माध्यम से InfluxDB, मैक्रो प्रतिस्थापन और सीमा प्रवर्तन के साथ ClickHouse, Snowflake, Athena, MySQL, PostgreSQL और MSSQL के लिए एकीकृत SQL टूल्स, CloudWatch नेमस्पेस, मीट्रिक्स और डाइमेंशन, Graphite रेंडर क्वेरीज़ और मीट्रिक डिस्कवरी, Elasticsearch/OpenSearch और Quickwit खोज, और उदाहरण क्वेरी पुनर्प्राप्ति शामिल है। SQL क्वेरीज़ Grafana डेटासोर्स प्लगइन्स के माध्यम से चलती हैं, इसलिए क्रेडेंशियल्स को MCP सर्वर के बजाय डेटासोर्स कॉन्फ़िगरेशन द्वारा संभाला जाता है। परिचालन क्षेत्रों में अलर्टिंग (नियमों की सूची बनाना, बनाना, अपडेट करना, हटाना; नोटिफिकेशन पॉलिसीज़, कॉन्टैक्ट पॉइंट्स, टाइम इंटरवल्स), Grafana Incident (खोज, बनाना, अपडेट करना, कस्टम फ़ील्ड्स), Sift इन्वेस्टिगेशन्स (सूची, विवरण, विश्लेषण, त्रुटि पैटर्न और धीमी रिक्वेस्ट का पता लगाना), Grafana OnCall (शेड्यूल, शिफ्ट्स, वर्तमान ऑन-कॉल उपयोगकर्ता, टीमें, उपयोगकर्ता, अलर्ट ग्रुप्स), एनोटेशन्स (क्वेरी, बनाना, अपडेट करना, पैच करना, हटाना, टैग), स्नैपशॉट्स (सूची, प्राप्त करना, बनाना, हटाना), Grafana Image Renderer के माध्यम से पैनल या डैशबोर्ड को PNG के रूप में रेंडर करना, प्रोविज़निंग रिपॉज़िटरी लिस्टिंग और ड्राई-रन वैलिडेशन, डैशबोर्ड, पैनल और Explore के लिए डीपलिंक जनरेशन, और मल्टी-ऑर्गनाइज़ेशन अनुरोधों के लिए उपयोगकर्ता पहचान लुकअप शामिल हैं। Grafana Cloud-केवल Agent Observability टूल्स में LLM वार्तालाप लिस्टिंग और खोज, मूल्यांकन स्कोर के साथ वार्तालाप और जनरेशन विवरण, संस्करण इतिहास और टोकन अनुमानों के साथ एक एजेंट कैटलॉग, मूल्यांकनकर्ता और टेम्पलेट्स, eval नियम और गार्ड्स, सहेजे गए वार्तालाप और संग्रह, टेस्ट सूइट्स, और ऑफ़लाइन प्रयोग शामिल हैं। इनमें से कुछ में एक विशिष्ट अनुमति के पीछे नियंत्रित राइट ऑपरेशन्स शामिल हैं। Grafana Assistant टूल्स सहायक को प्राकृतिक भाषा के प्रॉम्प्ट भेजते हैं और लौटाए गए कॉन्टेक्स्ट ID के माध्यम से वार्तालाप जारी रखने का समर्थन करते हैं; ये राइट टूल्स हैं और --disable-write सेट होने पर छोड़ दिए जाते हैं। एक्सेस कंट्रोल RBAC-आधारित है: प्रत्येक टूल को विशेष अनुमतियों और स्कोप्स की आवश्यकता होती है, और README आवश्यक अनुदानों के साथ एक सर्विस अकाउंट बनाने की सलाह देता है, यह देखते हुए कि एक अंतर्निहित Editor रोल एक सरल लेकिन कम विस्तृत विकल्प है। Incident और Sift टूल्स बारीक अनुमतियों के बजाय बेसिक Viewer/Editor रोल्स का उपयोग करते हैं। README में एक टूल तालिका शामिल है जो टूल नामों को श्रेणियों, आवश्यक RBAC अनुमतियों और आवश्यक स्कोप्स से मैप करती है।