خادم Home Assistant MCP

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

خادم Home Assistant MCP (hass-mcp) هو خادم بروتوكول Model Context Protocol (MCP) يربط بين المساعدات الذكية مثل Claude وغيرها من نماذج اللغة الكبيرة LLMs ونظام Home Assistant لديك. من خلال عرض بيانات ووظائف Home Assistant عبر معيار MCP، يمنح hass-mcp وكلاء الذكاء الاصطناعي القدرة على التفاعل، والاستعلام، والتحكم في أجهزة وأتمتة المنزل الذكي. تشمل المهام النموذجية التي يتيحها hass-mcp الاستعلام عن حالات الأجهزة والمستشعرات، تبديل الأضواء أو المفاتيح، تلخيص حالة المنزل، استكشاف أخطاء الأتمتة، البحث عن كائنات محددة، وتسهيل المحادثات الموجهة للأنشطة المنزلية الشائعة. يعزز هذا التكامل سير عمل المطورين والمستخدمين من خلال جعل إدارة المنزل الذكي متاحة عبر الذكاء الاصطناعي الحواري، والأتمتة، ووكلاء LLM.

قائمة التعليمات البرمجية (Prompts)

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

هل أنت مستعد لتنمية عملك؟

ابدأ تجربتك المجانية اليوم وشاهد النتائج في غضون أيام.

طلب عرض توضيحي تسجيل الدخول

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

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

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

• الاستعلام عن حالة الأجهزة والمستشعرات: يتيح لـ LLMs استرجاع الحالة الحالية لكائنات Home Assistant.
• التحكم في الأضواء، المفاتيح، والكائنات الأخرى: يتيح تحكمًا مباشرًا (تشغيل/إيقاف، السطوع، إلخ) في مكونات المنزل الذكي المدعومة.
• الحصول على ملخصات لمنزلك الذكي: يوفر نظرات عامة عالية المستوى أو معلومات مجمعة حول الحالة الحالية للمنزل.
• استكشاف أخطاء الأتمتة والكائنات: يقدم معلومات تشخيصية أو خطوات لحل المشكلات المتعلقة بالأتمتة أو كائنات الأجهزة.
• البحث عن كائنات محددة: يتيح للمستخدمين أو للوكلاء العثور على أجهزة أو مستشعرات بالاسم أو النوع ضمن Home Assistant.
• إنشاء محادثات موجهة للمهام الشائعة: يدعم تفاعلات منظمة لإرشاد المستخدمين خلال العمليات المنزلية المتكررة.

انضم إلى نشرتنا الإخبارية

احصل على أحدث النصائح والاتجاهات والعروض مجانًا.

عنوان البريد الإلكتروني

اشترك

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

• استعلام حالة الأجهزة: يمكن للمطورين والمستخدمين طلب الحالات الحالية برمجيًا أو حواريًا (مثال: “هل نافذة المطبخ مفتوحة؟")، مما يدعم المراقبة ومنطق الأتمتة.
• التحكم في المنزل الذكي: يمكّن المساعدين الصوتيين أو روبوتات الدردشة من تشغيل/إيقاف الأضواء، ضبط منظمات الحرارة، أو التحكم في الأجهزة المنزلية، مما يعزز سهولة الوصول والأتمتة.
• تقارير ملخص حالة المنزل: يمكن للنماذج اللغوية الكبيرة إنشاء ملخصات يومية أو عند الطلب (مثال: “ما حالة منزلي هذا المساء؟”) لراحة المستخدم أو دمجها في لوحات المعلومات.
• استكشاف أخطاء الأتمتة: يمكن للمطورين الاستفادة من خادم MCP لتحديد الأخطاء أو الإعدادات الخاطئة في الأتمتة، مما يسهل عملية التصحيح.
• البحث عن كائنات وإجراءات موجهة: البحث السريع عن الأجهزة أو إرشاد المستخدمين خلال إجراءات متعددة الخطوات (مثال: “إعداد روتين الصباح”) يبسط إدارة المنزل الذكي.

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

Windsurf

1. تأكد من تثبيت Python وDocker على جهازك.
2. استنسخ مستودع hass-mcp وقم بإعداد اتصالك بـ Home Assistant في ملف .env (راجع .env.example).
3. في Windsurf، افتح قسم إعدادات خوادم MCP.
4. أضف خادم hass-mcp باستخدام تكوين JSON مثل:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Windsurf. تحقق من ظهور الخادم في قائمة MCP.

Claude

1. انشر خادم hass-mcp محليًا أو على خادم يمكن لـ Claude الوصول إليه.
2. قم بتأمين مفتاح API الخاص بـ Home Assistant باستخدام متغيرات البيئة.
3. في تكوين Claude، أضف إدخال خادم MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. أعد تشغيل Claude وتحقق من توفر خادم MCP.
5. استخدم متغيرات البيئة لتأمين البيانات الحساسة (انظر أدناه).

Cursor

1. انشر hass-mcp وتأكد من وجود اتصال شبكي بين Cursor وخادم MCP.
2. قم بإعداد Cursor لاستخدام خادم MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. احفظ التكوين وأعد تشغيل Cursor.
4. عيّن متغيرات البيئة لمفاتيح API حسب الحاجة.

Cline

1. قم بتثبيت المتطلبات وشغّل خادم hass-mcp (راجع المستودع للمزيد من التفاصيل).
2. في Cline، افتح ملف تكوين MCP الخاص بك.
3. أضف خادم hass-mcp:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. أعد تشغيل Cline لتفعيل خادم MCP الجديد.

تأمين مفاتيح API (كل المنصات):

استخدم متغيرات البيئة في تكوينك لحماية المعلومات الحساسة:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

استنادًا إلى التوثيق والمحتوى المتاح في المستودع، يقدم hass-mcp أساسًا قويًا لتكامل Home Assistant عبر MCP، مع دعم أدوات واضح وممارسات إعداد/أمان معقولة. ومع ذلك، هناك نقص في قوالب التعليمات الصريحة، وتعريفات الموارد، أو ميزات MCP المتقدمة في التوثيق العام. أقيم هذا الخادم MCP بدرجة 6/10: عملي وصديق للمطورين، لكنه يفتقر إلى توثيق قابلية التوسعة وميزات MCP المتقدمة.

تقييم MCP