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 connettono le applicazioni di AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione di AI può comprendere.
Configurazione del server
Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per ulteriori informazioni 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 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 per sviluppatori Google. 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:
Questo strumento restituisce blocchi di testo, nomi e URL per i documenti corrispondenti. Se i chunk 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 sintetizza 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 generata e un elenco di nomi di documenti (riferimenti) utilizzati per generare la risposta. Se necessario, utilizza get_documents con i nomi dei documenti per recuperare l'intero contenuto del documento. Se ricevi un errore 429 di esaurimento della quota, utilizza search_documents. |
get_documents |
Utilizza questo strumento per recuperare l'intero contenuto di un singolo documento o fino a 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 dello strumento MCP
Per ottenere le specifiche dello strumento MCP per tutti gli strumenti di 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 }' |