MCP Reference: developerknowledge.googleapis.com

Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która dostarcza kontekst, dane lub funkcje do dużego modelu językowego (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, i tłumaczą 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 ze 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, ustandaryzowanego połączenia. Jest to punkt kontaktowy dla LLM, który umożliwia żądanie kontekstu, wywołanie narzędzia lub uzyskanie dostępu do zasobu. Punkty końcowe Google MCP mogą być globalne lub regionalne.

Serwer MCP interfejsu 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ść wykonywalna, którą serwer MCP udostępnia modelowi LLM lub aplikacji AI, aby wykonać działanie w świecie rzeczywistym.

Narzędzia

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

Narzędzia MCP
search_documents

Za pomocą tego narzędzia możesz znaleźć dokumentację dotyczącą usług Google dla deweloperów. Dokumenty zawierają oficjalne interfejsy API, fragmenty kodu, informacje o wersji, sprawdzone metody, przewodniki, dane debugowania i inne informacje. Dotyczy to tych usług i domen:

  • 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

  • Genkit: genkit.dev

  • 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, Google Maps, Youtube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Internet: web.dev

To narzędzie zwraca fragmenty tekstu, nazwy i identyfikatory URI pasujących dokumentów. Jeśli potrzebujesz dokładnych przykładowych kodów, flag interfejsu wiersza poleceń, konkretnych komunikatów o błędach, pełnych samouczków lub deterministycznego wyszukiwania słów kluczowych, użyj najpierw search_documents, a potem get_documents. Jeśli zwrócone fragmenty nie są wystarczająco szczegółowe, aby odpowiedzieć na pytanie użytkownika, użyj get_documents z parent z danych wyjściowych tego narzędzia, aby pobrać pełną treść dokumentu. Odpowiadając użytkownikowi, zawsze podawaj nazwy zasobów dokumentów źródłowych (documents/...) lub identyfikatory URI.
answer_query

Użyj metody answer_query, aby uzyskać powiązaną ze źródłem informacji, syntetyczną odpowiedź na ogólne pytanie dotyczące usług Google dla deweloperów. Jeśli potrzebujesz dokładnych przykładowych kodów, flag interfejsu wiersza poleceń, konkretnych komunikatów o błędach lub pełnych instrukcji dotyczących dokumentów, użyj search_documents, a następnie get_documents. 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 ostatecznej odpowiedzi dla użytkownika zawsze podawaj nazwy dokumentów źródłowych z references (documents/...). W razie potrzeby użyj get_documents z nazwami dokumentów z references, aby pobrać całą zawartość dokumentu.

Jeśli wystąpi błąd 429 (przekroczenie limitu), użyj metody search_documents.
get_documents Za pomocą tego narzędzia możesz pobrać pełną treść pojedynczego dokumentu lub maksymalnie 20 dokumentów w jednym wywołaniu. Nazwy dokumentów powinny być pobierane z pola parent wyników wywołania narzędzia search_documents lub z pola references zwracanego przez narzędzie answer_query. Ustaw parametr names na listę nazw dokumentów (documents/...) i podaj w odpowiedzi końcowej wiarygodne dokumenty źródłowe, które zostały użyte.

Pobieranie specyfikacji narzędzi MCP

Aby uzyskać specyfikacje wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak za pomocą curl 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
}'