/ الدليل / الملعب / unifi-mcp
← كل الخوادم ↗ GitHub
● مجتمع sirkirby ⚡ فوري

unifi-mcp

بواسطة sirkirby · sirkirby/unifi-mcp

تحكّم في مكوّنات Ubiquiti UniFi الخاصة بك — Network و Protect و Access — عبر محادثة مع Claude. 224 أداة تغطي كامل سطح المنتج.

unifi-mcp هو ثلاث خوادم MCP مدمجة: Network (161 أداة، مستقرة) و Protect (34 أداة، بيتا) و Access (29 أداة، بيتا). ربط الأحداث عبر المنتجات عبر مُرحّل سحابي اختياري. يتم التثبيت عبر uvx أو سوق إضافات Claude Code.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

unifi.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "unifi-mcp"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "unifi-mcp"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "unifi-mcp"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": [
        "unifi-mcp"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "unifi",
      "command": "uvx",
      "args": [
        "unifi-mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "unifi": {
      "command": {
        "path": "uvx",
        "args": [
          "unifi-mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add unifi -- uvx unifi-mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: unifi-mcp

التحقيق من تنبيه الحركة عبر الكاميرات والأبواب

👤 مستخدمو UniFi المنزليون والشركات الصغيرة والمتوسطة ⏱ ~10 min intermediate

متى تستخدمه: تلقيت تنبيه حركة من Protect الساعة 2 صباحاً. من كان؟ هل فُتح باب؟

المتطلبات الأساسية
  • وحدة التحكم UniFi + بيانات الاعتماد — UniFi UI > Admin > بيانات اعتماد API
الخطوات
  1. سحب حدث الحركة
    احصل على أحداث الحركة من Protect بين 01:55 و 02:05 اليوم. أدرج علامات الكشف الذكي.✓ تم النسخ
    → قائمة الأحداث مع علامات 'شخص' / 'مركبة'
  2. الربط مع الأبواب
    هل تم فتح أي أبواب Access في نفس الفترة الزمنية؟✓ تم النسخ
    → أحداث فتح الأبواب أو لا أحداث
  3. تفقد جانب الشبكة
    هل انضمت أي أجهزة جديدة/غير معروفة إلى الشبكة في تلك الفترة؟✓ تم النسخ
    → التغييرات في أجهزة الشبكة

النتيجة: فهم سريع للحادث المحتمل دون الانتقال بين 3 تطبيقات UniFi.

المزالق
  • تستخدم طوابع وقت Protect منطقة زمنية وحدة التحكم — اطلب دائماً من Claude تحويل الوقت إلى وقتك المحلي بشكل صريح

توفير وتدقيق شبكات الضيوف

👤 موظفو قسم تقنية المعلومات في المكتب، مضيفو Airbnb ⏱ ~10 min beginner

متى تستخدمه: تريد شبكة WiFi مؤقتة للضيوف للأسبوع، تنتهي صلاحيتها تلقائياً.

الخطوات
  1. إنشاء SSID
    أنشئ SSID ضيف 'Week42' على نطاقات 2.4 + 5 GHz برقم مرور عشوائي 12 حرف. تنتهي صلاحيته خلال 7 أيام.✓ تم النسخ
    → تم إنشاء SSID + إرجاع كلمة المرور
  2. المراجعة
    نهاية الأسبوع — كم جهازاً متصلاً، إجمالي النطاق الترددي، أي أنماط مريبة؟✓ تم النسخ
    → تقرير الاستخدام

النتيجة: أقل متاعب من القيام به في واجهة المستخدم.

المزالق
  • Claude يترك SSID نشطاً بعد انتهاء الصلاحية — عيّن قاعدة UniFi مجدولة؛ لا تعتمد على نموذج اللغة للتذكر

تدقيق قواعد جدار الحماية للانجراف

👤 المختبرات المنزلية المستضافة ذاتياً، مديرو الشركات الصغيرة والمتوسطة ⏱ ~30 min advanced

متى تستخدمه: لقد أضفت قواعد بمرور الوقت وتريد رأياً ثانياً حول ما هو مسموح فعلاً.

الخطوات
  1. تفريغ القواعد
    ضع قائمة بجميع قواعد جدار الحماية، مجمعة حسب المنطقة.✓ تم النسخ
    → جرد قواعد كامل
  2. التدقيق
    علّم أي قواعد تسمح بالوصول الوارد من 0.0.0.0/0 إلى الخدمات الداخلية. علّم القواعد المفرطة في الانفتاح.✓ تم النسخ
    → مجموعة فرعية معلمة بالمخاطر
  3. اقتراح التشديد
    لكل قاعدة معلمة، اقترح أقل تغيير في النطاق يحافظ على الوظيفة.✓ تم النسخ
    → اقتراحات فرق ملموسة

النتيجة: جدار حماية أكثر إحكاماً مُعدّ في جلسة واحدة.

المزالق
  • تطبيق التغييرات عشوائياً يقطع الاتصال — اطلب من Claude سرد التغييرات؛ طبّقها بنفسك عبر واجهة المستخدم لأي شيء متعلق بالبوابة

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

unifi + ssh-manager

تشغيل تشخيصات عميقة على وحدة تحكم عبر SSH عند عدم كفاية API

إذا لم يرجع استدعاء UniFi API أي بيانات لجهاز، اتصل بـ SSH إلى وحدة التحكم وشغّل info على معرّف ذلك الجهاز.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
network_list_clients site?: str معرفة الأجهزة المتصلة بشبكتك 1 API call
network_firewall_rules action: list|create|update|delete, ... تدقيق أو تغيير جدار الحماية 1 API call
network_health تشخيص نقاط الوصول غير المتصلة، معدلات الخطأ العالية 1 API call
protect_list_events start, end, cameras?, types? التحقيق من أحداث الحركة والكشف 1 API call
access_open_door door_id, duration_s? فتح الباب عن بعد — عملية مدمّرة؛ تأكد أولاً 1 API call + physical effect

التكلفة والحدود

تكلفة التشغيل

حصة API
وحدة التحكم الخاصة بك — لا توجد حدود خارجية
الرموز لكل استدعاء
استدعاءات القائمة 500-3000 رمز؛ العمليات الفردية 100-500
التكلفة المالية
مجاني، MIT. أجهزة UniFi والترخيصات هي نفقاتك الحالية.
نصيحة
فعّل فقط خوادم المنتج التي تستخدمها فعلاً — Network فقط لمعظم المختبرات المنزلية يقلل حمل المخطط.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: مستخدم admin مخصص في UniFi مع دور مقيّد بالمنتج المطلوب
تخزين بيانات الاعتماد: متغيرات UNIFI_HOST، UNIFI_USERNAME، UNIFI_PASSWORD البيئية؛ أو UNIFI_API_KEY تجريبي للقراءة فقط
نقل البيانات الخارجي: الشبكة المحلية إلى وحدة التحكم؛ مُرحّل سحابي اختياري لربط المنتجات
لا تمنح أبدًا: بيانات اعتماد Super Admin لوكيل يمكن أن يصل أيضاً إلى الإنترنت العام

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

لا يمكن الاتصال بوحدة التحكم

تحقق من UNIFI_HOST — أدرج https:// والمنفذ (مثل https://unifi.local:8443). شهادة موقّعة ذاتياً؟ عيّن UNIFI_VERIFY_SSL=false (للشبكة المحلية الموثوقة فقط).

تحقق: curl -k https://unifi.local:8443/api/system
401 غير مصرّح

بيانات الاعتماد خاطئة، أو يتطلب المصادقة الثنائية. أنشئ مسؤول محلي بدون المصادقة الثنائية للأتمتة.

أحداث Protect فارغة

تأكد من تثبيت Protect فعلاً على وحدة التحكم هذه. يؤكد protect_health.

البدائل

unifi-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
unifi-api-client في البرامج النصية المخصصةتريد تخصيص كامل ولا تستخدم الذكاء الاصطناعي للعملياتتكتب كل المادة اللاصقة؛ لا توجد ergonomics MCP

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills