Google Home Developer MCP-Server

Der Google Home-MCP-Server (Model Context Protocol) ermöglicht es KI-basierten Entwicklungstools, die folgenden Informationen zu durchsuchen und domänenspezifische Echtzeitinformationen abzurufen:

So wird sichergestellt, dass KI-Agents und ‑Tools genaue technische Antworten zu Google Home-Entwicklerprogrammen und ‑Technologien liefern können.

Ein MCP-Server fungiert als Proxy zwischen einem externen Dienst, der Kontext oder Daten bereitstellt, und einer KI-Anwendung (dem Host). Der Home Developer MCP-Server stellt ausführbare Tools bereit, mit denen Large Language Models (LLMs) präzise Antworten direkt aus indexierten Korpora finden können. Weitere Informationen zu MCP-Servern finden Sie unter Was ist das MCP und wie funktioniert es?.

Vorbereitung

Wenn Sie den Home Developer MCP-Server verwenden möchten, muss ein MCP-kompatibler KI-Client oder ‑Editor installiert sein.

Google Antigravity

Wenn Sie die KI-Entwicklungsumgebung von Google verwenden, installieren Sie eines der folgenden Tools:

KI‑Assistenten von Drittanbietern

Sie können das MCP auch in andere KI-Anwendungen, Befehlszeilentools und Code-Editoren einbinden, z. B.:

  • Claude Code
  • Cursor
  • GitHub Copilot (VS Code)

Authentifizierungspfad auswählen

Je nach Ihren Integrationsanforderungen können Sie entweder über einen nicht authentifizierten Testpfad oder über einen authentifizierten API-Schlüssel eine Verbindung zum MCP-Server für Entwickler von Smart-Home-Geräten herstellen.

Testen von nicht authentifizierten Verbindungen

Für diese Methode sind kein API-Schlüssel und keine Google Cloud-Konfiguration erforderlich. Es wird ein gemeinsames öffentliches Kontingent verwendet, sodass Sie den Server am einfachsten testen und die wichtigsten Funktionen sofort ausprobieren können.

Authentifizierte Verbindung für die Produktion

Um Ratenbegrenzungen bei gemeinsam genutzten öffentlichen Kontingenten zu vermeiden, empfiehlt es sich, Ihre Umgebung für eine nachhaltige Entwicklung zu authentifizieren.

Für diesen Pfad benötigen Sie ein aktives Google Cloud-Projekt.

  1. Aktivieren Sie die API in der Google Cloud Console für Ihr Projekt:
    1. Öffnen Sie die Seite Home Developers API in der Google APIs-Bibliothek.
    2. Prüfen Sie, ob Sie das richtige Projekt ausgewählt haben, in dem Sie die API verwenden möchten.
    3. Klicken Sie auf Aktivieren.
  2. API-Schlüssel erstellen:

    1. Rufen Sie die Seite Anmeldedaten auf.
    2. Klicken Sie auf Anmeldedaten erstellen und wählen Sie im Menü die Option „API-Schlüssel“ aus.
    3. Geben Sie im Feld Name einen Namen für den Schlüssel ein.
    4. Klicken Sie auf das Drop-down-Menü API-Einschränkungen auswählen und geben Sie Home Developers API ein. Klicken Sie auf das Ergebnis und dann auf OK.

    5. Klicken Sie auf Erstellen.

    6. Nachdem der Schlüssel erstellt wurde, klicken Sie auf Schlüssel anzeigen, um ihn aufzurufen, und kopieren Sie ihn für den nächsten Schritt.

Client konfigurieren

Es gibt mehrere Entwicklungsumgebungen, die entweder mit einer nicht authentifizierten oder einer authentifizierten Konfiguration eine Verbindung zum Home Developer MCP-Server herstellen können. Eine Anleitung zum Einrichten des Servers finden Sie in der Dokumentation der jeweiligen Umgebung.

Enter your API key: YOUR_API_KEY

Antigravity

Öffnen Sie Ihre lokale Konfigurationsdatei ~/.gemini/config/mcp_config.json und fügen Sie den Eintrag HomeDevelopers unter dem Objekt mcpServers hinzu.

Unabhängig davon, ob Sie die Antigravity CLI, Antigravity 2.0 oder die Antigravity IDE verwenden, nutzen alle diese Tools dieselbe Konfigurationsdatei unter ~/.gemini/config/mcp_config.json. Alle Änderungen oder Serverzuordnungen, die Sie in dieser Datei definieren, werden automatisch auf alle drei Umgebungen angewendet.

Nicht authentifiziert

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

Authentifiziert

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

Claude

Führen Sie den Befehl im Anwendungsverzeichnis aus, um Claude Code zu konfigurieren.

Nicht authentifiziert

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

Authentifiziert

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

Cursor

Wenn Sie Cursor konfigurieren möchten, bearbeiten Sie entweder .cursor/mcp.json (für ein bestimmtes Projekt) oder ~/.cursor/mcp.json (für alle Projekte).

Nicht authentifiziert

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

Authentifiziert

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

GitHub Copilot

Wenn Sie GitHub Copilot in VS Code für ein einzelnes Projekt konfigurieren möchten, bearbeiten Sie die Datei .vscode/mcp.json in Ihrem Arbeitsbereich. Alternativ können Sie den Server global verfügbar machen, indem Sie in Ihren Nutzereinstellungen auf die Schaltfläche Einstellungen (JSON) öffnen klicken und das JSON unter einem „mcp“-Stammschlüssel hinzufügen.

Nicht authentifiziert

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

Authentifiziert

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

Installation und Ausführung prüfen

Nachdem Sie die Toolkonfiguration aktualisiert haben, können Sie die Verbindung überprüfen, indem Sie den Agent-Arbeitsbereich auffordern.

Beispiel für die Überprüfung (Antigravity CLI)

  1. Starten Sie Ihre interaktive Workspace-Sitzung:

    agy
    

    Workspace-Sitzung starten

  2. Führen Sie das Makro für die Erkennungs-Checkliste aus, um aktive MCP-Server zu prüfen:

    /mcp
    
  3. Prüfe, ob HomeDevelopers (oder der von dir gewählte Schlüssel für den Servernamen) in der Liste der aktiven Verbindungen angezeigt wird.

    Entwickler für Zuhause bestätigen

  4. Stelle Google Home eine Frage, z. B.:

    How do I create an Automation using Home APIs?
    
  5. Wenn Antigravity der Meinung ist, dass die Entwicklerdokumentation für Google Home hilfreich sein kann, wird die Berechtigung zur Verwendung der search_documents-Tools des Home Developer MCP-Servers angefordert. Wählen Sie eine der Optionen unter Zulassen aus, um fortzufahren.

    Berechtigung erteilen

  6. Nachdem das Tool aufgerufen und die Anfrage analysiert wurde, antwortet Antigravity auf Ihre Anfrage.

    Antigravity-Reaktion

Videoanleitung

Im Video findest du eine detaillierte Anleitung zur Installation des MCP für Home-Entwickler.

Direkte HTTP-API-Testprotokolle (cURL)

Für Pipeline-Tests außerhalb einer Client-Wrapper-Umgebung können Standard-JSON-RPC-Nutzlasten über curl-Channels bereitgestellt werden.

Aktive Systemtools entdecken

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

Funktionale Suchanfrage ausführen

Nicht authentifiziert

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

Authentifiziert

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

Feedback geben

Über unser Feedbackformular können Sie uns Ihre Gedanken und Vorschläge zum MCP für Home-Entwickler mitteilen oder uns sagen, wie wir das Tool für Sie verbessern können.

Sende uns dein Feedback