خادم Loki MCP

ما الذي يفعله خادم “Loki” MCP؟

خادم Loki MCP هو تنفيذ مبني بلغة Go لبروتوكول Model Context (MCP) صمم للاندماج مع Grafana Loki، نظام تجميع السجلات. يعمل كجسر بين المساعدين الذكيين ومصادر بيانات السجلات الخارجية، مما يمكّن الذكاء الاصطناعي من استعلام والتفاعل مع تدفقات السجلات المخزنة في Loki. من خلال توفير إمكانيات الاستعلام في Loki عبر بروتوكول MCP، يمكن للمطورين وعملاء الذكاء الاصطناعي تعزيز تدفقات العمل الخاصة بهم—مثل البحث، الفلترة، وتحليل السجلات—مباشرة عبر واجهات نماذج اللغة القياسية. وهذا يمكّن من مهام مثل تحقيق السجلات الفوري، حل المشكلات، وإنشاء لوحات المتابعة، ويوفر وصولاً سلساً إلى بيانات التشغيل لتحسين الرصد والأتمتة.

قائمة المحفزات

لا توجد قوالب محفزات موثقة في المستودع.

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

لا توجد موارد MCP محددة موصوفة في المستودع.

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

• loki_query
  يتيح استعلام بيانات سجلات Grafana Loki.
  • المعلمات المطلوبة:
    • query: سلسلة استعلام LogQL
  • المعلمات الاختيارية:
    • url: عنوان خادم Loki (القيمة الافتراضية من متغير البيئة LOKI_URL أو http://localhost:3100)
    • start: وقت بدء الاستعلام (الافتراضي: قبل ساعة)
    • end: وقت نهاية الاستعلام (الافتراضي: الآن)
    • limit: الحد الأقصى لعدد النتائج (الافتراضي: 100)

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

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

كيفية إعداده

Windsurf

1. قم بتثبيت Go 1.16 أو أحدث.

2. قم ببناء الخادم:
   go build -o loki-mcp-server ./cmd/server

3. عدل إعدادات Windsurf لإضافة خادم MCP.

4. أضف خادم Loki MCP بمقطع JSON (عدل حسب الحاجة):

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Windsurf.

6. تحقق من أن الخادم يعمل ويمكن الوصول إليه.

تأمين مفاتيح API (مثال متغيرات البيئة):

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Claude

1. قم بتثبيت Go 1.16 أو أعلى.

2. أنشئ الخادم كما في الأعلى.

3. افتح ملف إعدادات MCP الخاص بـ Claude.

4. أضف خادم Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. احفظ/أعد تشغيل Claude.

6. تأكد من أن الإعداد يعمل.

تأمين مفاتيح API:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cursor

1. تأكد من تثبيت Go 1.16 أو أحدث.

2. أنشئ خادم Loki MCP.

3. عدل إعدادات Cursor.

4. أضف إدخال خادم Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. احفظ وأعد تشغيل Cursor.

6. تحقق من التكامل.

استخدام متغيرات البيئة:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cline

1. قم بتثبيت Go >=1.16.

2. الإنشاء:
   go build -o loki-mcp-server ./cmd/server

3. حدد موقع إعدادات خادم MCP لـ Cline.

4. أضف خادم Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. احفظ وأعد تشغيل Cline.

6. اختبر الإعداد.

تأمين مفاتيح API عبر env:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

استناداً إلى الجدول أعلاه، يقدم خادم Loki MCP نظرة عامة واضحة وأداة عملية لاستعلام السجلات، لكنه يفتقر إلى المحفزات الموثقة، الموارد، وميزات MCP المتقدمة مثل أخذ العينات أو الجذور. التوثيق محدود والإعداد موجه للمطورين.

رأينا

يركز خادم Loki MCP على التكامل الوظيفي مع استعلام سجلات Grafana Loki باستخدام النماذج اللغوية، لكنه بسيط ويفتقر إلى التنوع في ميزات MCP والتوثيق. بالنسبة للتقييم، يحصل على 4/10: يؤدي الغرض الأساسي لكنه ليس خادماً MCP متكاملاً أو موثقاً بشكل ممتاز.

درجة MCP