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.
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 chatmcp.googleapis.com ha i seguenti strumenti:
| Strumenti MCP | |
|---|---|
| list_messages | Recupera i messaggi da una conversazione di Google Chat specificata (spazio, messaggio diretto o messaggio diretto di gruppo). Consente di filtrare per thread, intervallo di tempo e numero di messaggi. Inoltre, è possibile recuperare la pagina successiva dei messaggi per fornire maggiore contesto. I messaggi privati (messaggi visibili solo a un singolo utente) vengono filtrati. |
| search_conversations |
Cerca le conversazioni di Google Chat in base al nome visualizzato. Se vengono forniti solo i partecipanti, questo strumento trova i messaggi diretti 1:1 (se viene fornito un partecipante) o le chat di gruppo (se vengono forniti più partecipanti) che includono i partecipanti specificati e l'utente che chiama. Se viene fornita solo una query, questo strumento cerca le conversazioni in cui la query è una sottostringa senza distinzione tra maiuscole e minuscole del nome visualizzato della conversazione. Se vengono forniti sia i partecipanti sia la query, questo strumento trova le conversazioni in base ai partecipanti e poi le filtra in base al nome visualizzato. Se non vengono forniti né i partecipanti né la query, questo strumento elenca tutte le conversazioni di cui l'utente che chiama è membro. Questo strumento elenca solo le conversazioni di cui l'utente che chiama è membro. IMPORTANTE: un elenco "conversazioni" vuoto non significa che non ci siano altri risultati in generale. Se è presente "next_page_token", è possibile recuperare altre pagine. Se ricevi un elenco vuoto ma un "next_page_token", chiedi all'utente se devi continuare la ricerca. |
Recuperare le specifiche degli strumenti MCP
Per recuperare 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://chatmcp.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |