خادم Keycloak MCP

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

يعد خادم Keycloak MCP (بروتوكول سياق النماذج) أداة متخصصة تتيح الإدارة المدعومة بالذكاء الاصطناعي لمستخدمي ومجالات Keycloak. يعمل كبوابة بين المساعدين الذكيين وKeycloak، مما يسمح للعملاء الخارجيين (مثل Claude Desktop ومنصات MCP المتوافقة الأخرى) بأتمتة مهام إدارة المستخدمين والمجالات. من خلال واجهة MCP، يمكن للمطورين تنفيذ عمليات إنشاء المستخدمين، حذفهم، عرض المجالات، وعرض المستخدمين بسلاسة. يعزز هذا من سير عمل التطوير وDevOps من خلال تمكين وكلاء الذكاء الاصطناعي من التفاعل البرمجي مع بنية المصادقة وإدارة المستخدمين، مما يجعل المهام الإدارية الروتينية أكثر كفاءة ويقلل من الجهد اليدوي.

قائمة النماذج الجاهزة

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

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

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

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

• create-user
  ينشئ مستخدماً جديداً في مجال محدد.
  المدخلات: المجال، اسم المستخدم، البريد الإلكتروني، الاسم الأول، اسم العائلة

• delete-user
  يحذف مستخدماً من مجال محدد.
  المدخلات: المجال، معرف المستخدم

• list-realms
  يعرض جميع مجالات Keycloak المتاحة.

• list-users
  يعرض جميع المستخدمين في مجال معين.
  المدخلات: المجال

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

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

كيفية إعداده

Windsurf

1. تأكد من تثبيت Node.js على نظامك.
2. حدد موقع ملف إعدادات Windsurf الخاص بك.
3. أضف خادم Keycloak MCP باستخدام مقطع JSON التالي:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Windsurf.
5. تحقق من نجاح الإعداد عبر التأكد من أن Windsurf يمكنه الاتصال بخادم Keycloak MCP.

Claude

1. تأكد من تثبيت Node.js.
2. افتح ملف إعدادات Claude Desktop الخاص بك.
3. أدرج التهيئة التالية تحت mcpServers:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. احفظ الملف وأعد تشغيل Claude Desktop.
5. أكد الاتصال بخادم Keycloak MCP.

Cursor

1. تأكد من إعداد Node.js.
2. ابحث وافتح ملف إعدادات Cursor.
3. أضف تفاصيل خادم Keycloak MCP:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Cursor.
5. تحقق من نجاح الاتصال.

Cline

1. ثبّت Node.js إذا لم يكن مثبتاً بالفعل.
2. ادخل إلى ملف إعدادات Cline.
3. أضف التهيئة التالية لخادم MCP:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. احفظ التغييرات وأعد تشغيل Cline.
5. تحقق أن Cline تعرف على خادم Keycloak MCP.

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

يُنصح باستخدام متغيرات البيئة للمعلومات الحساسة مثل بيانات الاعتماد الإدارية. مثال على التهيئة:

{
  "mcpServers": {
    "keycloak": {
      "command": "npx",
      "args": ["-y", "keycloak-model-context-protocol"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "${KEYCLOAK_ADMIN}",
        "KEYCLOAK_ADMIN_PASSWORD": "${KEYCLOAK_ADMIN_PASSWORD}"
      }
    }
  }
}

قم بتعيين متغيرات البيئة KEYCLOAK_ADMIN و KEYCLOAK_ADMIN_PASSWORD بشكل آمن في نظامك قبل تشغيل التطبيق.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

استناداً إلى التوثيق والميزات المتاحة، يوفر خادم Keycloak MCP أدوات أساسية قوية لإدارة Keycloak، لكنه يفتقر إلى ميزات MCP المتقدمة مثل قوالب الأوامر أو الموارد الصريحة أو دعم العينات. تكمن قيمته الأساسية في إدارة المستخدمين/المجالات بشكل مباشر عبر واجهات الذكاء الاصطناعي.

تقييم MCP

التقييم العام:
أقيّم هذا الخادم MCP بـ 5/10. يوفر أدوات أساسية موثقة جيداً لإدارة Keycloak، لكنه يفتقر إلى ميزات MCP المتقدمة ولا يتضمن ملف LICENSE، مما يحد من انتشاره وقابلية توسعه.