خادم Logfire MCP

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

خادم Logfire MCP هو خادم بروتوكول سياق النموذج (MCP) يتيح للمساعدين الذكيين ونماذج اللغة الكبيرة (LLMs) الوصول إلى بيانات القياس عن بُعد التي يتم إرسالها إلى Logfire عبر معيار OpenTelemetry واسترجاعها وتحليلها. من خلال ربط مشروع Logfire الخاص بك، يسمح هذا الخادم للأدوات والوكلاء المدعومين بالذكاء الاصطناعي باستعلام الآثار الموزعة، وفحص أنماط الاستثناءات، وتنفيذ استعلامات SQL مخصصة على بيانات القياسات والتتبع الخاصة بتطبيقك باستخدام واجهات برمجة تطبيقات Logfire. يتيح هذا التكامل تصحيح الأخطاء بسرعة، والمراقبة، وأتمتة مهام تحليل القياس الشائعة، مما يوفر للمطورين سير عمل محسّن لتصحيح الأخطاء والمراقبة واكتساب الرؤى مباشرة من بيئات التطوير أو وكلاء الذكاء الاصطناعي المساعدين.

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

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

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

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

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

• find_exceptions
  يسترجع عدد الاستثناءات من الآثار، مجمعة حسب الملف، خلال نافذة زمنية محددة.

• find_exceptions_in_file
  يوفر معلومات تتبع تفصيلية حول الاستثناءات التي تحدث في ملف معين خلال فترة زمنية محددة.

• arbitrary_query
  ينفذ استعلامات SQL مخصصة على آثار وقياسات OpenTelemetry، مما يتيح استكشاف البيانات بشكل مرن.

• get_logfire_records_schema
  يعيد مخطط OpenTelemetry، مما يمكّن المستخدمين من صياغة استعلامات مخصصة أكثر دقة.

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

• مراقبة وتحليل الاستثناءات
  يمكن للمطورين بسرعة تحديد الملفات التي تولد أكبر عدد من الاستثناءات، واكتشاف الاتجاهات، وتركيز جهود تصحيح الأخطاء.

• تحليل الأسباب الجذرية
  من خلال التعمق في تفاصيل الاستثناءات داخل ملف معين، يمكن للفرق تسريع تحديد المشكلات الحرجة وحلها.

• إعداد تقارير قياس مخصصة
  تُمكّن القدرة على تشغيل استعلامات SQL مخصصة الفرق من إنشاء تقارير ولوحات تحكم للقياس مصممة حسب احتياجاتهم الفريدة.

• استكشاف المخطط
  مع إمكانية الوصول إلى مخطط OpenTelemetry، يمكن للمطورين فهم حقول البيانات المتاحة بشكل أفضل لتحسين الاستعلامات المخصصة والتكاملات.

كيفية إعداده

Windsurf

لا توجد تعليمات إعداد متوفرة لـ Windsurf.

Claude

1. افتح إعدادات Claude Desktop.
2. أضف تكوين خادم MCP جديدًا باستخدام JSON التالي:

   {
     "command": ["uvx"],
     "args": ["logfire-mcp"],
     "type": "stdio",
     "env": {
       "LOGFIRE_READ_TOKEN": "YOUR_TOKEN"
     }
   }
   

3. استبدل "YOUR_TOKEN" برمز قراءة Logfire الفعلي الخاص بك.
4. احفظ الإعدادات وأعد تشغيل Claude.
5. تحقق من اتصال خادم MCP بمحاولة تنفيذ استعلام.

تأمين مفاتيح API:
قم بتخزين الرمز في قسم env كما في الأعلى لإبقائه خارج وسائط الاستدعاء والتحكم في النسخ المصدرية.

Cursor

1. تأكد من تثبيت uv.
2. أنشئ ملف .cursor/mcp.json في جذر مشروعك.
3. أضف التكوين التالي:

   {
     "mcpServers": {
       "logfire": {
         "command": "uvx",
         "args": ["logfire-mcp", "--read-token=YOUR-TOKEN"]
       }
     }
   }
   

4. استبدل "YOUR-TOKEN" برمز قراءة Logfire الفعلي الخاص بك.
5. احفظ الملف وأعد تشغيل Cursor.

ملاحظة: لا يدعم Cursor حقل env؛ استخدم وسيطة --read-token بدلاً من ذلك.

Cline

1. افتح أو أنشئ cline_mcp_settings.json.
2. أضف ما يلي:

   {
     "mcpServers": {
       "logfire": {
         "command": "uvx",
         "args": ["logfire-mcp"],
         "env": {
           "LOGFIRE_READ_TOKEN": "YOUR_TOKEN"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. استبدل "YOUR_TOKEN" برمز قراءة Logfire الخاص بك.
4. احفظ الملف وأعد تشغيل Cline.
5. تأكد من أن خادم MCP نشط.

تأمين مفاتيح API:
تظل الرموز آمنة عبر حقل env في ملف الإعدادات.

Windsurf

لا توجد تعليمات إعداد متوفرة لـ Windsurf.

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

استخدام MCP في FlowHunt

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

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

{
  "logfire": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

نظرة عامة

دعم الجذور: ⛔ (غير موثق)

دعم أخذ العينات: ⛔ (غير موثق)

استنادًا إلى ما سبق، يُعد خادم Logfire MCP خادم MCP متخصص عالي الجودة للإنتاج في مجال المراقبة، لكنه يفتقر إلى التوثيق لقوالب الاستعلامات والموارد والجذور أو دعم أخذ العينات. إنه متفوق في تقديم مجموعة صغيرة من الأدوات القيّمة للقياس وتصحيح الأخطاء. التقييم النهائي: 6/10 — ممتاز لحالة استخدامه، لكنه ليس تنفيذًا مرجعيًا كاملاً لـ MCP.

تقييم MCP