خادم MCP الخاص ببرنامج Google Home Developer

يمنح خادم بروتوكول سياق النموذج (MCP) الخاص بأداة Google Home للمطوّرين أدوات التطوير المستندة إلى الذكاء الاصطناعي القدرة على البحث عن ما يلي واسترداد معلومات في الوقت الفعلي خاصة بمجال معيّن:

• مركز المطوّرين في Google Home
• OpenThread
• مواصفات Matter: متاحة للإصدار 1.5.1

يساعد ذلك في ضمان قدرة أدوات ووكلاء الذكاء الاصطناعي على تقديم إجابات فنية دقيقة ذات صلة ببرامج وميزات Google Home للمطوّرين.

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

المتطلبات الأساسية

لاستخدام خادم MCP الخاص بأداة Home Developer، يجب أن يكون لديك برنامج تعديل أو عميل ذكاء اصطناعي متوافق مع MCP مثبّتًا.

Google Antigravity

إذا كنت تستخدم بيئة تطوير الذكاء الاصطناعي من Google، ثبِّت أحد ما يلي:

• ‫Antigravity CLI: يمكنك الاطّلاع على دليل بدء استخدام Antigravity CLI
• ‫Antigravity 2.0: يمكنك الاطّلاع على مستندات Google Antigravity
• ‫Antigravity IDE: يمكنك الاطّلاع على دليل بدء استخدام Antigravity IDE

المساعدون المستنِدون إلى الذكاء الاصطناعي التابعون لجهات خارجية

يمكنك أيضًا دمج MCP مع تطبيقات الذكاء الاصطناعي الأخرى وأدوات سطر الأوامر وأدوات تعديل الرموز، مثل:

• Claude Code
• المؤشر
• GitHub Copilot (في VS Code)

اختيار مسار مصادقة

استنادًا إلى متطلبات الدمج، يمكنك الربط بخادم MCP الخاص بمطوّري Home باستخدام مسار تجريبي غير مصادَق عليه أو مفتاح واجهة برمجة تطبيقات مصادَق عليه.

اختبار الاتصال غير المصادق عليه

لا تتطلّب هذه الطريقة أي مفتاح API أو إعداد Google Cloud. يستخدم هذا الخادم حصّة عامة مشتركة، ما يجعله أسهل طريقة لتجربة الخادم واختبار آليات اللعبة الأساسية على الفور.

اتصال مصادَق عليه في مرحلة الإنتاج

لتجنُّب فرض قيود على عدد الطلبات بموجب الحصص العامة المشتركة، ننصحك بإثبات ملكية بيئتك لضمان استمرار عملية التطوير.

يتطلّب منك هذا المسار أن يكون لديك مشروع نشط على Google Cloud.

1. في Google Cloud Console، فعِّل واجهة برمجة التطبيقات في مشروعك:
   1. افتح صفحة Home Developers API في مكتبة Google APIs.
   2. تأكَّد من اختيار المشروع الصحيح الذي تريد استخدام واجهة برمجة التطبيقات فيه.
   3. انقر على تفعيل.

2. إنشاء مفتاح واجهة برمجة تطبيقات:

   1. انتقِل إلى صفحة بيانات الاعتماد.
   2. انقر على إنشاء بيانات الاعتماد، ثمّ اختَر "مفتاح واجهة برمجة التطبيقات" من القائمة.
   3. في حقل الاسم، أدخِل اسمًا للمفتاح.

   4. انقر على القائمة المنسدلة اختيار قيود واجهة برمجة التطبيقات، ثم اكتب Home Developers API. انقر على النتيجة، ثم انقر على حسنًا.

   5. انقر على إنشاء.

   6. بعد إنشاء المفتاح، انقر على عرض المفتاح لعرضه، وانسَخه لتستخدمه في الخطوة التالية.

إعداد برنامجك

تتوفّر العديد من بيئات التطوير التي يمكنها الاتصال بخادم MCP الخاص بـ "مطوّر المنزل" باستخدام إعدادات غير مصادَق عليها أو إعدادات مصادقة. اطّلِع على تعليمات كل بيئة لإعداد الخادم.

Enter your API key: YOUR_API_KEY

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
 "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

التحقّق من التثبيت والتنفيذ

بعد تعديل إعدادات الأداة، تحقَّق من الاتصال عن طريق طلب مساحة عمل الوكيل.

مثال على عملية التحقّق (Antigravity CLI)

1. ابدأ جلسة مساحة العمل التفاعلية باتّباع الخطوات التالية:

   agy
   

   

2. نفِّذ وحدة ماكرو لقائمة التحقّق من الاكتشاف لفحص خوادم MCP النشطة:

   /mcp
   

3. تأكَّد من ظهور HomeDevelopers (أو مفتاح اسم الخادم الذي اخترته) في قائمة الاتصالات النشطة.

   

4. اطرح سؤالاً على Google Home، مثل:

   How do I create an Automation using Home APIs?
   

5. إذا كانت شركة Antigravity تعتقد أنّ الاطّلاع على مستندات المطوّرين في Google Home سيساعدها، فإنّها تطلب الإذن باستخدام أدوات search_documents في خادم MCP الخاص بمطوّري Home. انقر على أي من خيارات السماح للمتابعة.

   

6. بعد استدعاء الأداة والتفكير، سيجيب Antigravity عن طلبك بردّ مستند إلى معلومات موثوقة.

   

فيديو تعليمي

شاهِد الفيديو للحصول على دليل مفصَّل حول تثبيت حزمة MCP الخاصة بمطوّري تطبيقات المنزل الذكي.

بروتوكولات اختبار واجهة برمجة التطبيقات المباشرة HTTP (cURL)

بالنسبة إلى اختبار خطوط الإنتاج خارج بيئة برنامج تضمين العميل، يمكن تسليم حمولات JSON-RPC العادية عبر قنوات curl.

التعرّف على أدوات النظام النشطة

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

تنفيذ طلب بحث وظيفي

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

إرسال ملاحظات

يمكنك استخدام نموذج الملاحظات لإرسال أفكارك واقتراحاتك بشأن "برنامج المطوّرين المتعدّدين" في "الصفحة الرئيسية" أو بشأن كيفية تحسين تجربتك مع الأداة.

أرسل لنا ردك