خادم Home Assistant MCP

خادم Home Assistant MCP

اربط الذكاء الاصطناعي الحواري مع إعداد Home Assistant لديك باستخدام hass-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 إلى التدفق الخاص بك وربطه مع وكيل الذكاء الاصطناعي:

FlowHunt MCP flow

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

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

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


نظرة عامة

القسممتوفرالتفاصيل/ملاحظات
نظرة عامةملخص من README.md والمستودع
قائمة التعليمات البرمجيةلم يتم العثور على قوالب تعليمات صريحة
قائمة المواردلم يتم العثور على موارد MCP صريحة
قائمة الأدواتبناءً على وصف README.md
تأمين مفاتيح API.env.example ومذكورة في الإعداد
دعم Sampling (أقل أهمية في التقييم)لا يوجد إشارة إلى sampling في المستودع

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


تقييم MCP

يحتوي على رخصة✅ (MIT)
يحتوي على أداة واحدة على الأقل
عدد النسخ المتفرعة Forks16
عدد النجوم Stars107

الأسئلة الشائعة

ما هو خادم Home Assistant MCP؟

خادم Home Assistant MCP (hass-mcp) هو جسر بين المساعدات الذكية AI ونظام المنزل الذكي Home Assistant لديك. يعرض بيانات ووظائف Home Assistant عبر بروتوكول MCP، مما يتيح لوكلاء الذكاء الاصطناعي الاستعلام، والتحكم، وأتمتة الأجهزة بشكل حواري.

ما هي المهام التي يمكن أن يؤتمتّها hass-mcp؟

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

كيف أؤمّن مفتاح API الخاص بـ Home Assistant؟

استخدم متغيرات البيئة في تكوين خادم MCP الخاص بك (مثل ملف `.env`) للاحتفاظ ببيانات الاعتماد الحساسة مثل HASS_TOKEN في أمان بعيدًا عن قاعدة الشيفرة.

ما هي استخدامات hass-mcp النموذجية؟

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

ما هي رخصة وشعبية هذا الخادم؟

hass-mcp مرخص بموجب MIT وحصل على أكثر من 100 نجمة على GitHub وعدة نسخ متفرعة، مما يدل على اهتمام كبير من المطورين واستخدام مجتمعي واسع.

دمج Home Assistant مع FlowHunt

مكّن وكلاء الذكاء الاصطناعي لديك من التحكم ومراقبة منزلك الذكي مع hass-mcp. جرب التكامل في FlowHunt لأتمتة سلسة وتحكم حواري.

اعرف المزيد

تكامل خادم Todoist MCP
تكامل خادم Todoist MCP

تكامل خادم Todoist MCP

يصل خادم Todoist MCP بين المساعدين الذكيين وTodoist، مما يمكّن إدارة المهام بلغة طبيعية—أنشئ، حدّث، أكمل، وابحث عن المهام مباشرة من سير عمل FlowHunt لتحقيق إنتا...

4 دقيقة قراءة
AI Automation +4
خادم DesktopCommander MCP
خادم DesktopCommander MCP

خادم DesktopCommander MCP

يُمكّن خادم DesktopCommander MCP المساعدين الذكيين مثل Claude من أتمتة سطح المكتب بشكل مباشر، موفراً تحكمًا آمنًا في الطرفية، وبحثًا في نظام الملفات، وتحرير الم...

4 دقيقة قراءة
AI Automation Developer Tools +4
تكامل خادم MCP مع Kubernetes
تكامل خادم MCP مع Kubernetes

تكامل خادم MCP مع Kubernetes

يعمل خادم Kubernetes MCP كجسر بين المساعدين الذكيين ومجموعات Kubernetes، مما يمكّن من التشغيل الآلي المدفوع بالذكاء الاصطناعي، وإدارة الموارد، وتدفقات عمل DevOp...

4 دقيقة قراءة
AI Kubernetes +4