تكامل خادم Hyprmcp MCP

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

Hyprmcp هو خادم بروتوكول نموذج السياق (MCP) خفيف الوزن وغير رسمي يتيح للنماذج اللغوية الوصول إلى كافة وظائف hyprctl، وهي واجهة سطر الأوامر لمركب Hyprland Wayland. من خلال التكامل مع Hyprmcp، يمكن لمساعدي الذكاء الاصطناعي الاستعلام والتحكم في إدارة نوافذ Hyprland وتخطيطات النوافذ والمدخلات والمزيد باستخدام اللغة الطبيعية. هذا يعزز سير عمل المطورين والمستخدمين من خلال تمكينهم من تنفيذ مهام مثل جلب معلومات مساحات العمل، إدارة الشاشات، تشغيل أوامر Hyprland المختلفة، والحصول على حالة النظام — كل ذلك عبر واجهة ذكاء اصطناعي محادثية. تم تصميم هذا الخادم ليكون تجريبياً وفي مرحلة البيتا، ليشكل جسرًا بين مجموعة أوامر Hyprland الغنية وواجهات النماذج اللغوية الحديثة.

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

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

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

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

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

• run_hyprctl_command
  ينفذ أوامر hyprctl المختلفة.
• get_version
  يجلب معلومات إصدار وبناء Hyprland.
• list_monitors
  يعرض جميع الشاشات المتصلة وخصائصها.
• list_workspaces
  يعرض جميع مساحات العمل النشطة.
• list_clients
  (لم يتم تقديم وصف، لكن من المحتمل أنه يعرض عملاء/نوافذ Hyprland.)

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

• إدارة النوافذ عبر الذكاء الاصطناعي
  يمكّن مساعدي الذكاء الاصطناعي من التحكم والاستعلام عن نوافذ Hyprland وتخطيطات ومساحات العمل، مما يسهل تنظيم سطح المكتب.
• استعلامات حالة النظام المؤتمتة
  يمكن للمطورين استخدام اللغة الطبيعية لفحص إعدادات الشاشات، مساحات العمل النشطة، ونوافذ العملاء، مما يسهل التشخيص والبرمجة.
• تدقيق الإصدار والبيئة
  جلب معلومات إصدار/bبناء Hyprland لأغراض التشخيص أو التوثيق عبر استعلامات الذكاء الاصطناعي.
• التكامل مع أدوات التطوير
  دمج التحكم بـ Hyprland بسلاسة في عملاء MCP المتوافقة (مثل Claude، Cursor) لأتمتة المطور.
• أتمتة سير العمل المخصص
  استخدم أوامر hyprctl المختلفة عبر واجهات محادثية لإعدادات وسير عمل متقدمة وقابلة للتكرار.

كيفية إعداده

Windsurf

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

Claude

1. استنساخ المستودع
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. احصل على HYPRLAND_INSTANCE_SIGNATURE الخاص بك
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. تعديل الإعدادات
   • افتح ~/.config/Claude/claude_desktop_config.json
4. أضف خادم Hyprmcp MCP
   • أضف المقطع JSON التالي:

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<global path of the repo>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<global path of the repo>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
       }
     }
     

5. احفظ وأعد التشغيل
   • احفظ الملف وأعد تشغيل Claude Desktop لتطبيق التغييرات.

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

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

"env": {
  "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
}

Cursor

لا توجد تعليمات إعداد أو أمثلة تكوين متوفرة لـ Cursor.

Cline

لا توجد تعليمات إعداد أو أمثلة تكوين متوفرة لـ Cline.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

رأينا

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

تقييم MCP

التقييم: 5/10
جيد في الأساسيات (الأدوات، الرخصة، الوظيفة الأساسية)، لكنه يفتقر إلى توثيق القوالب/الموارد وتفاصيل الإعداد متعدد المنصات.