שרת MCP של Google Home Developer

שרת Model Context Protocol‏ (MCP) של Google Home Developer מאפשר לכלים מבוססי-AI לפיתוח לחפש את המידע הבא ולאחזר אותו בזמן אמת, לפי תחום ספציפי:

• מרכז המפתחים של Google Home
• OpenThread
• מפרט Matter: זמין לגרסה 1.5.1

הוא עוזר לוודא שכלי AI וסוכני AI יכולים לספק תשובות טכניות מדויקות שקשורות לתוכניות ולטכנולוגיות למפתחים של Google Home.

שרת MCP פועל כשרת proxy בין שירות חיצוני שמספק הקשר או נתונים לבין אפליקציית AI (המארח). שרת ה-MCP של Home Developer חושף כלים שניתנים להפעלה ומאפשרים למודלים גדולים של שפה (LLM) למצוא תשובות מדויקות ישירות ממאגרי מידע שעברו אינדוקס. מידע נוסף על שרתי MCP זמין במאמר מהו MCP ואיך הוא פועל?

דרישות מוקדמות

כדי להשתמש בשרת MCP של Home Developer, צריך להתקין לקוח AI או עורך שתואמים ל-MCP.

Google Antigravity

אם אתם משתמשים בסביבת הפיתוח של AI מבית Google, אתם צריכים להתקין את אחד מהבאים:

• ‫Antigravity CLI: אפשר לעיין במדריך תחילת העבודה עם Antigravity CLI
• ‫Antigravity 2.0: אפשר לעיין במסמכי התיעוד של Google Antigravity
• ‫Antigravity IDE: אפשר לעיין במדריך תחילת העבודה עם Antigravity IDE

עוזרים אישיים מבוססי-AI של צד שלישי

אפשר גם לשלב את ה-MCP עם אפליקציות אחרות מבוססות-AI, כלי שורת פקודה ועורכי קוד, כמו:

• Claude Code
• סמן
• ‫GitHub Copilot‏ (VS Code)

בחירת נתיב אימות

בהתאם לדרישות האינטגרציה, אפשר להתחבר לשרת ה-MCP של Home Developer באמצעות נתיב ניסיון לא מאומת או מפתח API מאומת.

בדיקת חיבור לא מאומת

השיטה הזו לא דורשת מפתח API או הגדרה של Google Cloud. הוא משתמש במכסת שימוש ציבורית משותפת, ולכן זו הדרך הקלה ביותר להתנסות בשרת ולבדוק את המנגנונים העיקריים באופן מיידי.

חיבור מאומת לסביבת הייצור

כדי למנוע הגבלת קצב בקשות במסגרת מכסות ציבוריות משותפות, מומלץ לאמת את הסביבה שלכם לפיתוח מתמשך.

כדי לבצע את השלבים האלה, צריך פרויקט פעיל ב-Google Cloud.

1. במסוף Google Cloud, מפעילים את ה-API בפרויקט:
   1. פותחים את הדף Home Developers API בספריית Google APIs.
   2. מוודאים שבחרתם את הפרויקט הנכון שבו אתם רוצים להשתמש ב-API.
   3. לוחצים על הפעלה.

2. יוצרים מפתח API:

   1. נכנסים לדף Credentials.
   2. לוחצים על Create credentials ובתפריט בוחרים באפשרות API key.
   3. בשדה Name (שם), מזינים שם למפתח.

   4. לוחצים על התפריט הנפתח Select API restrictions ומקלידים Home Developers API. לוחצים על התוצאה ואז על אישור.

   5. לוחצים על יצירה.

   6. אחרי שיוצרים את המפתח, לוחצים על הצגת המפתח כדי לראות אותו ומעתיקים אותו לשלב הבא.

הגדרת הלקוח

יש כמה סביבות פיתוח שאפשר להתחבר אליהן לשרת MCP של Home Developer באמצעות הגדרה לא מאומתת או הגדרת אימות. הוראות להגדרת השרת מפורטות בכל סביבה.

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. מפעילים את הסשן האינטראקטיבי של Workspace:

   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 יענה לשאלה עם תשובה מבוססת.

   

סרטון הדרכה

בסרטון הבא יש מדריך מפורט להתקנה של Home Developer MCP.

פרוטוקולים לבדיקה ישירה של HTTP API‏ (cURL)

לצורך בדיקת צינורות מחוץ לסביבת עטיפת לקוח, אפשר להעביר מטענים ייעודיים (payloads) רגילים של 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?"
        }
    }
}'

שליחת משוב

אתם יכולים להשתמש בטופס המשוב כדי לשלוח את המחשבות וההצעות שלכם לגבי Home Developer MCP או לגבי שיפור חוויית השימוש בכלי.

נשמח לקבל ממך משוב