MCP Reference: developerknowledge.googleapis.com

Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione di AI. I server MCP collegano le applicazioni di AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato comprensibile per l'applicazione di AI.

Configurazione del server

Prima di utilizzarli, devi attivare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.

Endpoint server

Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito un URL) del server MCP che un'applicazione di AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint Google MCP possono essere globali o regionali.

Il server MCP dell'API Developer Knowledge ha il seguente endpoint MCP globale:

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

Strumenti MCP

Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.

Strumenti

Il server MCP developerknowledge.googleapis.com dispone dei seguenti strumenti:

Strumenti MCP
search_documents

Utilizza questo strumento per trovare la documentazione sui prodotti Google Developers. I documenti contengono API ufficiali, snippet di codice, note di rilascio, best practice, guide, informazioni di debug e altro ancora. Riguarda i seguenti prodotti e domini:

  • 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

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

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

  • Google Developers, Ads, Ricerca, 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

  • Web: web.dev

Questo strumento restituisce blocchi di testo, nomi e URI per i documenti corrispondenti. Preferisci search_documents seguito da get_documents quando hai bisogno di esempi di codice esatti, flag CLI, messaggi di errore specifici, procedure dettagliate dei tutorial o ricerca di parole chiave deterministica. Se i segmenti restituiti non sono abbastanza dettagliati per rispondere alla domanda dell'utente, utilizza get_documents con parent dall'output di questo strumento per recuperare i contenuti completi del documento. Quando rispondi all'utente, cita sempre i nomi delle risorse dei documenti di origine autorevoli (documents/...) o gli URI.
answer_query

Utilizza answer_query per ottenere una risposta concettuale sintetizzata e fondata a una domanda di alto livello sui prodotti Google Developers. Per esempi di codice esatti, flag dell'interfaccia a riga di comando, messaggi di errore specifici o procedure dettagliate per i documenti completi, preferisci search_documents seguito da get_documents. Questo strumento ha una quota limitata. Questo strumento sintetizzerà le informazioni del corpus per generare una risposta alla query. answer_query basa le risposte sullo stesso corpus di search_documents. Questo strumento restituisce il testo della risposta generato e un elenco di nomi di documenti (riferimenti) utilizzati per generare la risposta. Cita sempre i nomi dei documenti delle fonti autorevoli di references (documents/...) nella tua risposta finale all'utente. Utilizza get_documents con i nomi dei documenti di references per recuperare l'intero contenuto del documento, se necessario.

Se ricevi un errore 429 di quota esaurita, utilizza search_documents.
get_documents Utilizza questo strumento per recuperare i contenuti completi di un singolo documento o di un massimo di 20 documenti in una singola chiamata. I nomi dei documenti devono essere ottenuti dal campo parent dei risultati di una chiamata allo strumento search_documents o dal campo references restituito dallo strumento answer_query. Imposta il parametro names su un elenco di nomi di documenti (documents/...) e cita i documenti di origine autorevoli utilizzati nella risposta finale.

Ottieni le specifiche dello strumento MCP

Per ottenere le specifiche degli strumenti MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili all'interno del server MCP.

Richiesta 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
}'