Serwer MCP Google Home Developer

Serwer Model Context Protocol (MCP) dla deweloperów Google Home umożliwia narzędziom programistycznym opartym na AI wyszukiwanie i pobieranie w czasie rzeczywistym informacji dotyczących konkretnych domen:

Pomaga to zapewnić, że agenty i narzędzia AI mogą udzielać dokładnych odpowiedzi technicznych związanych z programami i technologią dla deweloperów Google Home.

Serwer MCP działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst lub dane, a aplikacją AI (hostem). Serwer MCP dla deweloperów Home udostępnia narzędzia wykonywalne, które umożliwiają dużym modelom językowym (LLM) znajdowanie dokładnych odpowiedzi bezpośrednio w indeksowanych korpusach. Więcej informacji o serwerach MCP znajdziesz w artykule Co to jest MCP i jak działa?.

Wymagania wstępne

Aby korzystać z serwera MCP dla deweloperów Home, musisz mieć zainstalowanego klienta lub edytor AI zgodny z MCP.

Google Antigravity

Jeśli korzystasz ze środowiska programistycznego AI Google, zainstaluj jedną z tych opcji:

Asystenci AI innych firm

Możesz też zintegrować MCP z innymi aplikacjami AI, narzędziami wiersza poleceń i edytorami kodu, takimi jak:

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

Wybierz ścieżkę uwierzytelniania

W zależności od wymagań integracji możesz połączyć się z serwerem MCP dla deweloperów Home za pomocą nieautoryzowanej ścieżki testowej lub uwierzytelnionego klucza interfejsu API.

Testowanie połączenia bez uwierzytelnienia

Ta metoda nie wymaga klucza interfejsu API ani konfiguracji Google Cloud. Korzysta z wspólnego limitu publicznego, co sprawia, że jest to najprostszy sposób na przetestowanie serwera i natychmiastowe sprawdzenie podstawowych mechanizmów.

Uwierzytelnione połączenie na potrzeby produkcji

Aby zapobiec ograniczaniu liczby żądań w ramach wspólnych limitów publicznych, zalecamy uwierzytelnienie środowiska na potrzeby ciągłego rozwoju.

Ta ścieżka wymaga aktywnego projektu Google Cloud.

  1. W konsoli Google Cloud włącz interfejs API w projekcie:
    1. Otwórz stronę Home Developers API w bibliotece interfejsów API Google.
    2. Sprawdź, czy masz wybrany prawidłowy projekt, w którym chcesz używać interfejsu API.
    3. Kliknij Włącz.
  2. Utwórz klucz interfejsu API:

    1. Otwórz stronę Dane logowania.
    2. Kliknij Utwórz dane logowania, a potem w menu wybierz Klucz interfejsu API.
    3. W polu Nazwa wpisz nazwę klucza.
    4. Kliknij menu Wybierz ograniczenia interfejsu API, a potem wpisz Home Developers API. Kliknij wynik, a potem OK.

    5. Kliknij Utwórz.

    6. Po utworzeniu klucza kliknij Pokaż klucz, aby go wyświetlić, i skopiuj go na potrzeby następnego kroku.

Skonfiguruj usługę klienta

Istnieje kilka środowisk programistycznych, które mogą łączyć się z serwerem MCP dla deweloperów Home za pomocą konfiguracji bez uwierzytelnienia lub z uwierzytelnieniem. Aby skonfigurować serwer, postępuj zgodnie z instrukcjami dotyczącymi każdego środowiska.

Enter your API key: YOUR_API_KEY

Antigravity

Otwórz lokalny plik konfiguracyjny ~/.gemini/config/mcp_config.json i dodaj wpis HomeDevelopers w obiekcie mcpServers.

Niezależnie od tego, czy używasz Antigravity CLI, Antigravity 2.0 czy Antigravity IDE, wszystkie te narzędzia korzystają z tego samego pliku konfiguracyjnego znajdującego się w lokalizacji ~/.gemini/config/mcp_config.json. Wszelkie zmiany lub mapowania serwerów zdefiniowane w tym pliku są automatycznie stosowane we wszystkich 3 środowiskach.

Bez uwierzytelnienia

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

Z uwierzytelnieniem

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

Claude

Aby skonfigurować Claude Code, uruchom polecenie w katalogu aplikacji.

Bez uwierzytelnienia

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

Z uwierzytelnieniem

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

Kursor

Aby skonfigurować kursor, edytuj plik .cursor/mcp.json (w przypadku konkretnego projektu) lub ~/.cursor/mcp.json (w przypadku wszystkich projektów).

Bez uwierzytelnienia

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

Z uwierzytelnieniem

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

GitHub Copilot

Aby skonfigurować GitHub Copilot w VS Code na potrzeby jednego projektu, edytuj plik .vscode/mcp.json w obszarze roboczym. Aby udostępnić serwer globalnie, kliknij przycisk Otwórz ustawienia (JSON) w ustawieniach użytkownika i dodaj kod JSON w kluczu głównym „mcp”.

Bez uwierzytelnienia

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

Z uwierzytelnieniem

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

Sprawdź instalację i wykonanie

Po zaktualizowaniu konfiguracji narzędzia sprawdź połączenie, wysyłając zapytanie do obszaru roboczego agenta.

Przykład weryfikacji (Antigravity CLI)

  1. Uruchom interaktywną sesję w obszarze roboczym:

    agy
    

    Uruchamianie sesji obszaru roboczego

  2. Uruchom makro listy kontrolnej wykrywania, aby sprawdzić aktywne serwery MCP:

    /mcp
    
  3. Sprawdź, czy na liście aktywnych połączeń widnieje HomeDevelopers (lub wybrana nazwa klucza serwera).

    Potwierdzanie dewelopera aplikacji Home

  4. Zadaj pytanie Google Home, na przykład:

    How do I create an Automation using Home APIs?
    
  5. Jeśli Antigravity uzna, że pomocne będzie przeczytanie dokumentacji dla deweloperów Google Home, poprosi o zgodę na użycie narzędzi search_documents serwera MCP dla deweloperów Home. Aby kontynuować, wybierz dowolną opcję Zezwól.

    Przyznaj uprawnienia

  6. Po wywołaniu narzędzia i przemyśleniu odpowiedzi Antigravity odpowie na Twoje pytanie, podając uzasadnioną odpowiedź.

    Odpowiedź Antigravity

Samouczek wideo

Obejrzyj film, aby uzyskać szczegółowe instrukcje instalacji MCP dla deweloperów Home.

Protokoły testowania bezpośredniego interfejsu API HTTP (cURL)

W przypadku testowania potoku poza środowiskiem otoki klienta standardowe ładunki JSON-RPC można dostarczać za pomocą kanałów curl.

Odkrywanie aktywnych narzędzi systemowych

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

Uruchamianie funkcjonalnego zapytania

Bez uwierzytelnienia

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

Z uwierzytelnieniem

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

Prześlij opinię

Użyj formularza opinii, aby przesłać swoje uwagi i sugestie dotyczące MCP dla deweloperów Home lub tego, jak możemy ulepszyć Twoje wrażenia z korzystania z tego narzędzia.

Prześlij opinię