عن المشروع

خادم Grafana MCP هو خادم Model Context Protocol (MCP) يربط عملاء MCP مثل Claude Desktop أو Cursor بمثيل 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 مع اكتشاف التسميات والأنماط، وInfluxDB عبر InfluxQL أو Flux، وأدوات SQL موحّدة لـ ClickHouse وSnowflake وAthena وMySQL وPostgreSQL وMSSQL مع استبدال الماكرو وفرض الحدود، ومساحات أسماء CloudWatch والمقاييس والأبعاد، واستعلامات عرض Graphite واكتشاف المقاييس، والبحث في Elasticsearch/OpenSearch وQuickwit، واسترجاع أمثلة الاستعلامات. تُنفَّذ استعلامات SQL عبر إضافات مصادر بيانات Grafana، لذا تُدار بيانات الاعتماد عبر تهيئة مصدر البيانات بدلاً من خادم MCP. تشمل المجالات التشغيلية التنبيهات (سرد القواعد وإنشاؤها وتحديثها وحذفها؛ وسياسات الإشعارات ونقاط الاتصال والفترات الزمنية)، وGrafana Incident (البحث والإنشاء والتحديث والحقول المخصصة)، وتحقيقات Sift (السرد والتفاصيل والتحليلات واكتشاف أنماط الأخطاء والطلبات البطيئة)، وGrafana OnCall (الجداول والمناوبات والمستخدمين المناوبين حاليًا والفرق والمستخدمين ومجموعات التنبيهات)، والتعليقات التوضيحية (الاستعلام والإنشاء والتحديث والترقيع والحذف والوسوم)، واللقطات (السرد والجلب والإنشاء والحذف)، وعرض اللوحات أو لوحات المعلومات كـ PNG عبر Grafana Image Renderer، وسرد مستودع التزويد والتحقق التجريبي، وإنشاء روابط عميقة للوحات المعلومات واللوحات وExplore، والبحث عن هوية المستخدم للطلبات متعددة المؤسسات. تغطي أدوات Agent Observability الخاصة بـ Grafana Cloud فقط سرد محادثات LLM والبحث فيها، وتفاصيل المحادثة والتوليد مع درجات التقييم، وكتالوج الوكيل مع سجل الإصدارات وتقديرات الرموز، والمقيّمين والقوالب، وقواعد التقييم والحراس، والمحادثات والمجموعات المحفوظة، ومجموعات الاختبار، والتجارب دون الاتصال. يتضمن بعضها عمليات كتابة محكومة بصلاحية محددة. ترسل أدوات Grafana Assistant مطالبات باللغة الطبيعية إلى المساعد وتدعم متابعة المحادثة عبر معرّف سياق مُعاد؛ وهي أدوات كتابة ويتم تخطيها عند تعيين --disable-write. يعتمد التحكم في الوصول على RBAC: تحتاج كل أداة إلى صلاحيات ونطاقات معينة، وينصح README بإنشاء حساب خدمة بالمنح اللازمة، مع الإشارة إلى أن دور Editor المدمج بديل أبسط لكنه أقل تفصيلاً. تستخدم أدوات Incident وSift أدوار Viewer/Editor الأساسية بدلاً من الصلاحيات الدقيقة. يتضمن README جدول أدوات يربط أسماء الأدوات بالفئات وصلاحيات RBAC المطلوبة والنطاقات المطلوبة.