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

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

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

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

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

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

لاستخدام خادم Home Developer MCP، يجب أن يكون لديك برنامج تعديل أو عميل ذكاء اصطناعي متوافق مع 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 Developer باستخدام مسار تجريبي غير مصادق عليه أو مفتاح واجهة برمجة تطبيقات مصادق عليه.

اختبار الاتصال بدون مصادقة

لا تتطلّب هذه الطريقة مفتاح واجهة برمجة تطبيقات أو إعدادات 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. بعد إنشاء المفتاح، انقر على عرض المفتاح لعرضه، وانسَخه لتستخدمه في الخطوة التالية.

ضبط إعدادات العميل

أدخِل بيانات الاعتماد في الحقول التالية لملء نماذج الإعدادات لبيئة تطوير الذكاء الاصطناعي المفضّلة لديك:

Enter your API key: YOUR_API_KEY

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

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

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

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

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

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

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

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

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

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

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

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

   agy
   

   

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

   /mcp
   

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

   

4. طرح سؤال حول تطوير تطبيقات Google Home، مثل:

   How do I create an Automation using Home APIs?
   

5. عندما يطلب تطبيق Antigravity الإذن باستدعاء أداة search_documents الخاصة بخادم Home Developer MCP، انقر على أي من خيارات السماح للمتابعة.

   

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

   

فيديو تعليمي

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

الاختبار باستخدام طلبات curl مباشرة عبر HTTP

لاختبار خطوط المعالجة خارج بيئة عميل الذكاء الاصطناعي، يمكنك إرسال حمولات JSON-RPC 2.0 العادية مباشرةً إلى https://homedevelopers.googleapis.com/mcp باستخدام curl.

استكشاف أدوات النظام النشطة

استخدِم طريقة tools/list لفحص الأدوات التي يعرضها الخادم:

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

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

اختَر علامة تبويب لاختبار search_documents باستخدام مفتاح واجهة برمجة تطبيقات أو طلب غير مصادَق عليه:

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?"
          }
      }
  }'

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

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

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

أرسل لنا ردك