/ الدليل / الملعب / prometheus-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع pab1it0 ⚡ فوري

prometheus-mcp-server

بواسطة pab1it0 · pab1it0/prometheus-mcp-server

الاستعلام عن Prometheus باللغة الطبيعية — استعلامات PromQL الفورية والنطاق، فحص الأهداف، بيانات المقاييس، لفريق SRE بدعم الذكاء الاصطناعي.

يوفر prometheus-mcp-server (pab1it0) ستة أدوات عبر Prometheus HTTP API. يدعم استعلامات PromQL واستعلامات النطاق واكتشاف المقاييس وصحة الأهداف. يعمل مع المصادقة الأساسية ورموز Bearer و mTLS والرؤوس المخصصة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

prometheus.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "prometheus": {
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "prometheus": {
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "prometheus": {
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "prometheus": {
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "prometheus",
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "prometheus": {
      "command": {
        "path": "uvx",
        "args": [
          "prometheus-mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add prometheus -- uvx prometheus-mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: prometheus-mcp-server

كيفية تشخيص ارتفاع في زمن الانتظار باستخدام Prometheus + Claude

👤 مهندسو SRE في الخدمة ⏱ ~10 min intermediate

متى تستخدمه: عند تفعيل تنبيه p99 للخدمة — تحتاج إلى السياق دون حفظ PromQL.

المتطلبات الأساسية
  • عنوان Prometheus قابل للوصول — عيّن PROMETHEUS_URL في إعدادات MCP؛ أضف مصادقة إذا كانت محمية
الخطوات
  1. تحديد نطاق الارتفاع
    استعلم عن كمون طلب HTTP p99 للخدمة X في الساعة الأخيرة، بدقة 30 ثانية. قارن مع خط الأساس في آخر 7 أيام.✓ تم النسخ
    → نتيجة استعلام النطاق تظهر الارتفاع
  2. البحث عن المقاييس المرتبطة
    لنافذة الارتفاع، ما المقاييس الأخرى للخدمة X التي تحركت أكثر من 2 sigma؟ CPU والذاكرة و GC وعمق الطابور؟✓ تم النسخ
    → المقاييس المشتبه بها
  3. تضييق النطاق حسب التسمية
    قسّم الارتفاع حسب تسميات pod/host. هل يتعلق بـ pod واحد أم بالمجموعة كلها؟✓ تم النسخ
    → تقسيم حسب التسمية

النتيجة: فرضية مرتبطة بمقاييس معينة في أقل من 5 دقائق.

المزالق
  • الاستعلام لا يعيد بيانات — تحقق من أسماء التسميات باستخدام list_metrics — تختلف حالة التسمية والفواصل بين المُصدّرات
اجمعها مع: kubectl

توليد تقرير الامتثال لـ SLO الأسبوعي من Prometheus

👤 قادة SRE ⏱ ~25 min intermediate

متى تستخدمه: مراجعة SLO يوم الجمعة — تريد أرقام وليس انطباعات.

الخطوات
  1. تعريف مؤشرات SLI
    للخدمة X احسب توفر هذا الأسبوع (نسبة النجاح/الإجمالي) وكمون التأخير (الطلبات تحت الحد الأدنى / الإجمالي) كأرقام.✓ تم النسخ
    → نسبتان مع معدل الحرق
  2. المقارنة مع SLO
    SLO التوفر = 99.9%، SLO كمون التأخير = 95%. هل أنا فوق أم تحت؟ احسب استنزاف ميزانية الخطأ.✓ تم النسخ
    → الحكم + عدد أيام الميزانية المتبقية

النتيجة: تقرير SLO قابل للدفاع برقم وليس 'في الغالب بخير'.

اجمعها مع: google-sheets

تدقيق صحة هدف الكشط في Prometheus مع Claude

👤 مهندسو المنصة ⏱ ~15 min intermediate

متى تستخدمه: تشك بأن نصف أهدافك معطل لكنك لم تتحقق.

الخطوات
  1. الحصول على الأهداف
    استدعِ get_targets. جمّع حسب المهمة؛ أيها يحتوي على حالات DOWN؟✓ تم النسخ
    → جدول المهمة → عدد الحالات الصاعدة/الهابطة
  2. التحقيق
    للحالة الأسوأ، أظهر lastError للحالات DOWN. السبب المحتمل؟✓ تم النسخ
    → سبب قابل للتنفيذ لكل هدف

النتيجة: إنقاذ الكشط في دقائق.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

prometheus + kubectl

ربط الشذوذ في المقاييس مع حالة pod

للخدمة مع ارتفاع كمون التأخير، ارتبط بيانات Prometheus مع kubectl describe على الـ pods الخاصة بها.✓ تم النسخ
prometheus + sentry

ارتفاع المقياس وارتفاع الخطأ الترابطي

يُظهر Sentry أن الأخطاء تضاعفت في 14:00 — ما مقاييس Prometheus التي تحركت في نفس الوقت؟✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
health_check التحقق من الاتصال 1 API call
execute_query query: promql, time? لقطة فورية 1 query
execute_range_query query, start, end, step تحليل السلاسل الزمنية 1 query (may be expensive)
list_metrics match?: str الاكتشاف عندما لا تعرف اسم المقياس 1 API call
get_metric_metadata metric: str فهم الوحدات قبل الحساب 1 API call
get_targets صحة الكشط 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
يتسع Prometheus مع الخادم الخاص بك؛ الاستعلامات المكلفة قد تجهد الخادم
الرموز لكل استدعاء
يمكن لاستعلامات النطاق مع العديد من السلاسل أن تصل إلى 10000+ رمز
التكلفة المالية
مجاني
نصيحة
استخدم step بحكمة في استعلامات النطاق؛ دقة 10 ثوان على مدار 24 ساعة تعطي 8640 عينة لكل سلسلة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: وصول القراءة فقط إلى Prometheus API
تخزين بيانات الاعتماد: رمز Bearer أو مصادقة أساسية في المتغيرات البيئية؛ مسارات شهادات mTLS إذا تم استخدامها
نقل البيانات الخارجي: عنوان URL لـ Prometheus الخاص بك فقط

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

الاستعلام يعود فارغ بدون خطأ

اسم المقياس/التسمية غير موجود. استخدم list_metrics مع بادئة التطابق للتحقق

انتهاء مهلة استعلام النطاق

قلل نطاق الوقت أو زيادة step. لمحرك استعلام Prometheus حدود موارد لكل استعلام

401 مع رمز Bearer

الرمز لا يمتلك إذن القراءة على /api/v1؛ تحقق من reverse proxy إذا كان Prometheus خلفها

تحقق: curl -H 'Authorization: Bearer $T' $PROMETHEUS_URL/api/v1/status/config

البدائل

prometheus-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Grafana MCPإذا كنت بالفعل تصور البيانات في Grafana وتريد عمليات لوحة المعلومات والتنبيهاتأثقل؛ ميزات أكثر مما قد تحتاج
Datadog MCPإذا كان Datadog هو متجر المقاييس الخاص بكمدفوع؛ لغة استعلام مختلفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills