تكامل خادم Inoyu MCP Unomi

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

خادم Inoyu MCP Unomi هو خادم بروتوكول سياق النماذج (MCP) يدمج MCP من Anthropic مع منصة بيانات العملاء (CDP) Apache Unomi. يتيح ذلك للمساعدين الذكيين مثل Claude التفاعل مع ملفات تعريف المستخدمين داخل Unomi وإدارتها، مما يسهل الوعي السياقي وديمومة بيانات المستخدمين عبر الجلسات. يدعم الخادم البحث عن الملفات الشخصية وإنشائها باستخدام البريد الإلكتروني، إدارة خصائص الملف الشخصي، التعامل مع الجلسات، وإدارة النطاقات لعزل السياق. من خلال إتاحة هذه الإمكانيات عبر MCP، يمكن لوكلاء الذكاء الاصطناعي تنفيذ عمليات متقدمة على بيانات المستخدمين، مثل جلب أو تحديث معلومات المستخدم، مما يعزز تدفقات التطوير التي تتطلب إدارة بيانات مستخدمين دائمة وغنية بالسياق.

قائمة القوالب البرمجية

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

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

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

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

• get_my_profile
  يجلب ملف تعريف المستخدم باستخدام متغيرات البيئة. يدعم جلب معلومات التقسيم والنقاط وينشئ معرف جلسة بناءً على التاريخ الحالي.

• update_my_profile
  يحدث خصائص ملف تعريف المستخدم. يقبل كائن خصائص بمفاتيح وقيم تدعم أنواع بيانات متنوعة (نص، رقم، منطقية، فارغ).

• get_profile
  يجلب ملف تعريف محدد حسب معرفه من Unomi، ويعيد بيانات الملف الشخصي الكاملة.

• search_profiles
  يبحث في الملفات الشخصية بناءً على سلسلة استعلام، مع معلمات اختيارية للحد والإزاحة. يبحث عبر حقول الاسم الأول، الاسم الأخير، والبريد الإلكتروني.

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

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

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

Windsurf

لا توجد تعليمات محددة لـ Windsurf.

Claude

1. تأكد من توفر المتطلبات (Node.js وnpx).
2. حدد موقع ملف الإعدادات:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. أضف إعدادات خادم Inoyu MCP Unomi:

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_USERNAME": "your-username",
        "UNOMI_PASSWORD": "your-password",
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "your-unomi-key",
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}

4. احفظ الإعدادات.
5. أعد تشغيل Claude Desktop لتطبيق التغييرات والتحقق من اكتشاف الخادم/الأدوات.

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

استخدم قسم env في إعدادات JSON لتعيين بيانات الاعتماد الحساسة كمتغيرات بيئة.

Cursor

لا توجد تعليمات محددة لـ Cursor.

Cline

لا توجد تعليمات محددة لـ Cline.

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

استخدام MCP في FlowHunt

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

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

{
  "inoyu-unomi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

نظرة عامة

رأينا

يوفر هذا الخادم MCP تكاملًا قويًا لإدارة ملفات تعريف المستخدمين مع Apache Unomi من خلال مجموعة أدوات واضحة وإعداد مباشر لـ Claude Desktop. ومع ذلك، فإن غياب قوالب التعليمات، تعريفات الموارد الصريحة، والتعليمات الخاصة بالمنصات لـ Windsurf وCursor وCline يحد من اكتماله. هو الأنسب حاليًا للتجربة والتعلم في هذه المرحلة.

تقييم MCP

التقييم: 6/10
يعد خادم Inoyu MCP Unomi واعدًا لإدارة ملفات Unomi والتكامل مع الذكاء الاصطناعي، لكن كونه في مرحلة مبكرة، وغياب تفاصيل الموارد/القوالب، وقلة الإعداد متعدد المنصات يقلل من فائدته الحالية لجمهور المطورين الأوسع.