Serveur MCP Google Home pour les développeurs

Le serveur MCP (Model Context Protocol) Google Home Developer permet aux outils de développement basés sur l'IA de rechercher les éléments suivants et de récupérer des informations en temps réel spécifiques à un domaine :

Il permet de s'assurer que les agents et outils d'IA peuvent fournir des réponses techniques précises concernant les programmes et technologies pour les développeurs Google Home.

Un serveur MCP fait office de proxy entre un service externe qui fournit le contexte ou les données et une application d'IA (l'hôte). Le serveur MCP Home Developer expose des outils exécutables qui permettent aux grands modèles de langage (LLM) de trouver des réponses précises directement à partir de corpus indexés. Pour en savoir plus sur les serveurs MCP, consultez Qu'est-ce que le MCP et comment fonctionne-t-il ?.

Prérequis

Pour utiliser le serveur MCP Home Developer, vous devez avoir installé un client ou un éditeur d'IA compatible avec le MCP.

Google Antigravity

Si vous utilisez l'environnement de développement d'IA de Google, installez l'un des éléments suivants :

Assistants d'IA tiers

Vous pouvez également intégrer le MCP à d'autres applications d'IA, outils de ligne de commande et éditeurs de code, tels que :

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

Choisir un chemin d'authentification

Selon vos exigences d'intégration, vous pouvez vous connecter au serveur MCP Home Developer à l'aide d'un chemin d'essai non authentifié ou d'une clé API authentifiée.

Test de connexion non authentifié

Cette méthode ne nécessite aucune clé API ni configuration Google Cloud. Elle utilise un quota public partagé, ce qui en fait le moyen le plus simple d'essayer le serveur et de tester immédiatement les mécanismes de base.

Connexion authentifiée pour la production

Pour éviter la limitation du débit sous les quotas publics partagés, il est recommandé d'authentifier votre environnement pour un développement continu.

Ce chemin nécessite que vous disposiez d'un projet Google Cloud actif.

  1. Dans la console Google Cloud, activez l'API dans votre projet :
    1. Ouvrez la page API Home Developers dans la bibliothèque des API Google.
    2. Vérifiez que le projet dans lequel vous souhaitez utiliser l'API est sélectionné.
    3. Cliquez sur Activer.
  2. Créez une clé API :

    1. Accédez à la page Identifiants.
    2. Cliquez sur Créer des identifiants, puis sélectionnez Clé API dans le menu.
    3. Dans le champ Nom, indiquez un nom pour la clé.
    4. Cliquez sur le menu déroulant Sélectionner les restrictions relatives aux API, puis saisissez API Home Developers. Cliquez sur le résultat, puis sur OK.

    5. Cliquez sur Créer.

    6. Une fois la clé créée, cliquez sur Afficher la clé pour l'afficher, puis copiez-la pour l'étape suivante.

Configurer votre client

Plusieurs environnements de développement peuvent se connecter au serveur MCP Home Developer à l'aide d'une configuration non authentifiée ou d'une configuration d'authentification. Consultez les instructions de chaque environnement pour configurer le serveur.

Enter your API key: YOUR_API_KEY

Antigravity

Ouvrez votre fichier de configuration local ~/.gemini/config/mcp_config.json et ajoutez l'entrée HomeDevelopers sous l'objet mcpServers.

Que vous utilisiez la CLI Antigravity, Antigravity 2.0 ou l'IDE Antigravity, tous ces outils partagent le même fichier de configuration situé dans ~/.gemini/config/mcp_config.json. Toutes les modifications ou tous les mappages de serveur que vous définissez dans ce fichier s'appliquent automatiquement aux trois environnements.

Non authentifiés

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

Authentifiée

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

Claude

Pour configurer Claude Code, exécutez la commande sous le répertoire de votre application.

Non authentifiés

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

Authentifiée

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

Cursor

Pour configurer Cursor, modifiez .cursor/mcp.json (pour un projet spécifique) ou ~/.cursor/mcp.json (pour tous les projets).

Non authentifiés

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

Authentifiée

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

GitHub Copilot

Pour configurer GitHub Copilot dans VS Code pour un seul projet, modifiez le fichier .vscode/mcp.json dans votre espace de travail. Vous pouvez également rendre le serveur disponible globalement en cliquant sur le bouton Ouvrir les paramètres (JSON) dans vos paramètres utilisateur et en ajoutant le JSON sous une clé racine "mcp".

Non authentifiés

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

Authentifiée

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

Vérifier l'installation et l'exécution

Une fois la configuration de votre outil mise à jour, vérifiez la connexion en invitant votre espace de travail d'agent.

Exemple de validation (CLI Antigravity)

  1. Lancez votre session d'espace de travail interactif :

    agy
    

    Lancer une session d'espace de travail

  2. Exécutez la macro de liste de contrôle de la découverte pour inspecter les serveurs MCP actifs :

    /mcp
    
  3. Vérifiez que HomeDevelopers (ou la clé de nom de serveur que vous avez choisie) apparaît dans la liste des connexions actives.

    Confirmer le développeur pour la maison

  4. Posez une question à Google Home, par exemple :

    How do I create an Automation using Home APIs?
    
  5. Si Antigravity pense que la lecture de la documentation pour les développeurs Google Home vous sera utile, il demande l'autorisation d'utiliser les outils search_documents du serveur MCP Home Developer. Sélectionnez l'une des options Autoriser pour continuer.

    Accordez l'autorisation

  6. Après avoir appelé l'outil et réfléchi, Antigravity répondra à votre requête avec une réponse fondée.

    Réponse Antigravity

Tutoriel vidéo

Regardez la vidéo pour obtenir un guide pas à pas sur l'installation du MCP Home Developer.

Protocoles de test d'API HTTP directe (cURL)

Pour les tests de pipeline en dehors d'un environnement de wrapper client, les charges utiles JSON-RPC standards peuvent être fournies via des canaux curl.

Découvrir les outils système actifs

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

Exécuter une requête de recherche fonctionnelle

Non authentifiés

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

Authentifiée

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

Envoyer des commentaires

Utilisez notre formulaire de commentaires pour nous faire part de vos réflexions et suggestions concernant le MCP Home Developer ou la manière dont nous pouvons améliorer votre expérience avec l'outil.

Envoyez-nous vos commentaires