خادم Simple Loki MCP

ما وظيفة خادم “Simple Loki” MCP؟

خادم Simple Loki MCP هو واجهة بروتوكول Model Context (MCP) تُمكّن مساعدي الذكاء الاصطناعي من استعلام وتحليل السجلات مباشرة من مثيل Grafana Loki. باستخدام أدوات مثل logcli أو بالاعتماد على واجهة Loki HTTP API، يسمح هذا الخادم بدمج بيانات السجلات بسهولة في تدفقات تطوير البرمجيات. يدعم الاستعلام الكامل عبر LogQL، واسترجاع قيم التصنيفات، ويوفر نتائج بتنسيقات إخراج متعددة (افتراضي، خام، JSON lines). وبفضل مرونته في المصادقة والإعداد عبر متغيرات البيئة أو ملفات الإعدادات، يُعد Simple Loki MCP Server مثالياً لتعزيز الرصد، واستكشاف الأخطاء، ومهام المراقبة ضمن التطبيقات أو تدفقات الأتمتة المعتمدة على الذكاء الاصطناعي.

قائمة البرومبتات

لا توجد قوالب برومبت صريحة مذكورة في المستودع أو الوثائق.

قائمة الموارد

لا توجد موارد MCP صريحة مذكورة في المستودع أو الوثائق.

قائمة الأدوات

• query-loki
  استعلام السجلات من Loki مع خيارات تصفية. تتيح هذه الأداة للمستخدمين إرسال استعلامات LogQL واسترجاع إدخالات السجلات، مع دعم العديد من تنسيقات الإخراج والوصول إلى بيانات التصنيفات.

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

• تحليل السجلات واستكشاف الأخطاء
  يمكن للمطورين استخدام خادم Simple Loki MCP لتحليل وتصنيف بيانات السجلات من Grafana Loki، مما يسهل تصحيح التطبيقات والتحقق من المشكلات.
• الاستجابة التلقائية للحوادث
  يستطيع مساعدو الذكاء الاصطناعي جلب وتلخيص السجلات ذات الصلة تلقائياً أثناء تدفقات معالجة الحوادث، مما يحسّن سرعة الاستجابة والدقة.
• لوحات الرصد
  دمج إمكانيات استعلام السجلات ضمن لوحات معلومات مخصصة، لتمكين رؤى لحظية مباشرة في أدوات التطوير أو المراقبة.
• مراقبة الأمان
  استخدم وكلاء الذكاء الاصطناعي لمراقبة السجلات بحثاً عن أنماط أو أنشطة مشبوهة، مع إمكانية إطلاق تنبيهات أو إجراءات تلقائية عند رصد الشذوذ.
• تحسين الأداء
  تحليل بيانات السجلات التاريخية لاكتشاف عنق الزجاجة أو الأخطاء أو الاتجاهات المؤثرة في أداء النظام، والمساعدة في التحسين الاستباقي.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js v16+.
2. عدّل ملف إعدادات Windsurf (مثل settings.json).
3. أضف خادم Simple Loki MCP إلى قسم mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. احفظ وأعد تشغيل Windsurf.
5. تحقق من عمل الخادم من خلال إمكانيات استعلام السجلات.

Claude

1. ثبّت Node.js v16+.
2. استخدم Smithery لتثبيت الخادم:

   npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude
   

3. أضف/حدث إعدادات Claude على النحو التالي:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. احفظ وأعد تشغيل Claude.
5. تأكد من توفر إمكانيات استعلام سجلات Loki.

Cursor

1. تأكد من تثبيت Node.js v16+.
2. افتح ملف إعدادات Cursor.
3. أضف ما يلي تحت mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. احفظ التغييرات وأعد تشغيل Cursor.
5. اختبر وظيفة استعلام السجلات.

Cline

1. تأكد من توفر Node.js v16+.
2. حدد موقع ملف إعدادات Cline وافتحه.
3. أضف إدخال Simple Loki MCP:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. احفظ وأعد تشغيل Cline.
5. تحقق من نجاح تكامل استعلام السجلات.

حماية مفاتيح API

خزن بيانات الاعتماد الحساسة (مثل LOKI_ADDR أو الرموز) في متغيرات البيئة لضمان الأمان. مثال:

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "${LOKI_ADDR_ENV}",
        "LOKI_TOKEN": "${LOKI_TOKEN_ENV}"
      },
      "inputs": {
        "query": "${YOUR_LOGQL_QUERY}"
      }
    }
  }
}

كيفية استخدام هذا MCP ضمن التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في تدفق عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه مع وكيل الذكاء الاصطناعي:

انقر على مكون MCP لفتح لوحة الإعداد. في قسم إعدادات النظام MCP، أدرج تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق:

{
  "simple-loki": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، يصبح بإمكان وكيل الذكاء الاصطناعي استخدام هذا MCP كأداة مع إمكانية الوصول لجميع وظائفه. لا تنس استبدال “simple-loki” باسم خادم MCP الفعلي الخاص بك وتغيير الرابط إلى رابط خادم MCP الخاص بك.

نظرة عامة

استناداً إلى الجدول أعلاه، يركز خادم Simple Loki MCP على الوظيفة ويؤديها بشكل جيد لكنه يفتقر إلى التغطية في البرومبتات والموارد. من السهل إعداده وتوجد وثائق واضحة للتكامل وحماية مفاتيح API. بشكل عام، هو عملي لاستعلام السجلات لكنه محدود في القدرات المتقدمة لـ MCP.

تقييم MCP

التقييم:
أعطي هذا الخادم MCP 6/10. إنه قوي في مهمته وسهل التكامل، لكنه يفتقر إلى التنوع في الأدوات، وقوالب البرومبت، وتعريفات الموارد الصريحة الضرورية لاستخدام MCP بشكل أوسع. لم يتم ذكر الجذور أو دعم أخذ العينات.