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 AI. I server MCP collegano le applicazioni AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.
Configurazione del server
Prima dell'uso, devi abilitare 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 (in genere un URL) del server MCP che un'applicazione 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 MCP di Google possono essere globali o regionali.
Il server MCP developerknowledge.googleapis.com ha il seguente endpoint MCP:
- 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.
Il server MCP developerknowledge.googleapis.com ha i seguenti strumenti:
| Strumenti MCP | |
|---|---|
| search_documents |
Utilizza questo strumento per trovare la documentazione sui prodotti per sviluppatori Google. I documenti contengono API ufficiali, snippet di codice, note di rilascio, best practice, guide, informazioni di debug e altro ancora. Copre i seguenti prodotti e domini:
Questo strumento restituisce blocchi di testo, nomi e URL per i documenti corrispondenti. Se i blocchi restituiti non sono sufficientemente dettagliati per rispondere alla domanda dell'utente, utilizza |
| answer_query | Utilizza answer_query per ottenere una risposta basata su una query sui prodotti per sviluppatori Google. Questo strumento ha una quota limitata. Questo strumento sintetizzerà le informazioni del corpus per generare una risposta alla query. answer_query basa le risposte utilizzando lo stesso corpus di search_documents. Se ricevi un errore 429 di quota, utilizza search_documents. |
| get_documents |
Utilizza questo strumento per recuperare l'intero contenuto 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. Imposta il parametro names su un elenco di nomi di documenti.
|
Ottenere le specifiche degli strumenti 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 nel 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 }' |