Grafana MCP: اسرد مصادر البيانات أولًا ولا تسحب لوحة كبيرة كاملة من البداية

لمن يناسب

يناسب من لديه أصلًا نسخة Grafana 9.0 أو أحدث ويريد أن ينظر النموذج في النسخة والنظام المحيط (اللوحات ومصادر البيانات). الأدلة تنص: يوفّر هذا MCP وصولًا إلى نسخة Grafana والنظام البيئي حولها.

يجب أن تقدّم GRAFANA_URL ورمز حساب خدمة GRAFANA_SERVICE_ACCOUNT_TOKEN. دون 9.0 قد تتعذر بعض الوظائف (خاصة المتعلقة بالمصادر) لنقص واجهات API.

الأدلة لا تسرد العملاء ولا تكتب معظم أسماء دوال الأدوات. في المرة الأولى عرض للقراءة فقط: لا تفعّل panel query المعطّل افتراضيًا، ولا تستخدم مثال localhost:3000 كما هو في الإنتاج.

أول محاولة في 3 دقائق

اتبع مسار uvx الرئيسي. في العميل اضبط:

"command": "uvx",
"args": ["mcp-grafana"],
"env": {
  "GRAFANA_URL": "http://localhost:3000",
  "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}

استبدل عنوان URL بنسختك والرمز برمز حساب خدمة. لا تكتبهما في المحادثة.

المتطلبات: Grafana ≥ 9.0 قابل للوصول؛ وصلاحيات حساب الخدمة كافية لسرد المصادر أو قراءة اللوحات. هذا الاستدعاء يصل إلى Grafana لديك بالرمز وليس صندوق رمل بلا شبكة.

موضع الإعداد: command / args / env لـ MCP في العميل.

أول استدعاء منخفض المخاطر: أولًا «سرد معلومات مصادر البيانات وجلبها» (قدرة الأدلة). لا تسحب أولًا لوحة كبيرة كاملة حسب UID. أدوات Run panel query معطّلة افتراضيًا؛ لا تضف runpanelquery إلى --enabled-tools لأجل المحاولة الأولى.

إشارة النجاح: بعد اتصال العميل ترى قائمة المصادر المضبوطة. إن ظهر 401 أو انقطع الاتصال فتحقق أولًا من URL والرمز وما إذا كانت النسخة ≥ 9.0.

حالات الاستخدام

الحالة 1: معرفة مصادر النسخة. استخدم «List and fetch datasource information». الأدلة تذكر أنواعًا مدعومة منها Prometheus وLoki وClickHouse وCloudWatch وElasticsearch وOpenSearch وSnowflake وAthena. لا تعطي أسماء دوال أدوات ولا معاملات تصفية. ما يمكن تأكيده: المصادر المضبوطة وتفاصيلها.

الحالة 2: جلب التفاصيل الكاملة للوحة حسب UID. تحذّر الأدلة: اللوحات الكبيرة تستهلك نافذة سياق كبيرة. اختر لوحة تعرف UID لها وليست ضخمة؛ إن طال الرد توقف عند «الأدلة حذّرت من استهلاك السياق» ولا تكرر السحب الكامل. الأدلة لا تعطي نص locator لأداة تقليم JSONPath؛ لا تختلق اسم أداة بديل.

حدود الاستخدام

يلزم Grafana 9.0+ وGRAFANA_URL ورمز حساب خدمة. runpanelquery معطّل افتراضيًا ولا يشغّل panel query إلا بعد التفعيل. جلب لوحة كاملة حسب UID قد يفجر السياق. أنواع المصادر المذكورة أعلاه فقط. لا undo ولا جدول أسماء كامل ولا صلاحية دنيا للرمز. الوصول إلى Grafana والمصادر ليس بلا مخاطر: ما يراه حساب الخدمة يراه النموذج. لا تقرأ «سرد المصادر للقراءة فقط» على أنها بلا شبكة أو بلا أسماء مقاييس حسّاسة.