MCP Reference: developerknowledge.googleapis.com

Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub możliwości dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.

Konfiguracja serwera

Przed użyciem musisz włączyć serwery MCP i skonfigurować uwierzytelnianie. Więcej informacji o korzystaniu z zdalnych serwerów MCP Google i Google Cloud znajdziesz w artykule Omówienie serwerów MCP Google Cloud.

Punkty końcowe serwera

Punkt końcowy usługi MCP to adres sieciowy i interfejs komunikacyjny (zwykle adres URL) serwera MCP, którego aplikacja AI (host klienta MCP) używa do nawiązywania bezpiecznego, standardowego połączenia. Jest to punkt kontaktowy, za pomocą którego LLM może poprosić o kontekst, wywołać narzędzie lub uzyskać dostęp do zasobu. Punkty końcowe Google MCP mogą być globalne lub regionalne.

Serwer MCP Developer Knowledge API ma ten globalny punkt końcowy MCP:

  • https://developerknowledge.googleapis.com/mcp

Narzędzia MCP

Narzędzie MCP to funkcja lub możliwość wykonywania, którą serwer MCP udostępnia LLM lub aplikacji AI w celu wykonania działania w świecie rzeczywistym.

Narzędzia

Serwer MCP developerknowledge.googleapis.com ma te narzędzia:

Narzędzia MCP
search_documents

Użyj tego narzędzia, aby znaleźć dokumentację produktów Google dla deweloperów. Dokumenty zawierają oficjalne interfejsy API, fragmenty kodu, informacje o wersji, sprawdzone metody, przewodniki, informacje o debugowaniu i inne. Obejmuje te produkty i domeny:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Interfejs wiersza poleceń Gemini: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com i docs.cloud.google.com

  • Google Developers, Ads, Search, Mapy Google, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Internet: web.dev

To narzędzie zwraca fragmenty tekstu, nazwy i adresy URL pasujących dokumentów. Jeśli zwrócone fragmenty nie są wystarczająco szczegółowe, aby odpowiedzieć na pytanie użytkownika, użyj get_documents z parametrem parent z danych wyjściowych tego narzędzia, aby pobrać pełną treść dokumentu.
answer_query

Użyj answer_query, aby uzyskać odpowiedź na pytanie dotyczące produktów Google dla deweloperów. To narzędzie ma ograniczony limit. To narzędzie będzie syntetyzować informacje z korpusu, aby wygenerować odpowiedź na zapytanie. answer_query opiera odpowiedzi na tym samym korpusie co search_documents. To narzędzie zwraca wygenerowany tekst odpowiedzi i listę nazw dokumentów (odniesień) użytych do wygenerowania odpowiedzi. W razie potrzeby użyj get_documents z nazwami dokumentów, aby pobrać całą treść dokumentu.

Jeśli otrzymasz błąd 429 z powodu przekroczenia limitu, użyj zamiast tego search_documents.
get_documents Użyj tego narzędzia, aby pobrać pełną treść pojedynczego dokumentu lub maksymalnie 20 dokumentów w jednym wywołaniu. Nazwy dokumentów należy uzyskać z pola parent wyników wywołania narzędzia search_documents. Ustaw parametr names na listę nazw dokumentów.

Pobieranie specyfikacji narzędzi MCP

Aby uzyskać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak użyć curl, aby wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.

Żądanie Curl 
                      
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'