Si tratta di un server MCP fornito dall'API Google Calendar. Il server fornisce agli sviluppatori gli strumenti per creare applicazioni LLM basate su Calendar.
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 di poterlo utilizzare, devi configurare il server MCP di Calendar. 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.
L'API MCP di Calendar ha il seguente endpoint MCP globale:
- https://calendarmcp.googleapis.com/mcp/v1
Strumenti MCP
Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un'applicazione LLM o AI per eseguire un'azione nel mondo reale.
Strumenti
Il server MCP calendarmcp.googleapis.com ha i seguenti strumenti:
| Strumenti MCP | |
|---|---|
list_events |
Restituisce gli eventi nel calendario specificato che corrispondono a tutti i vincoli specificati. I vincoli di tempo non devono essere specificati a meno che non siano richiesti dall'utente. Per le ricerche di parole chiave o basate su argomenti a tempo indeterminato nel calendario principale, è necessario utilizzare lo strumento search_events. |
get_event |
Restituisce un singolo evento nel calendario specificato. |
list_calendars |
Restituisce i calendari a cui questo utente ha accesso (il suo elenco di calendari). Utilizza questo strumento per risolvere i dati di identificazione del calendario (ad esempio "il mio calendario di famiglia") nel relativo calendar_id (identificatore email)
|
suggest_time |
Suggerisce periodi di tempo in uno o più calendari. |
create_event |
Crea un evento nel calendario specificato. |
update_event |
Aggiorna un evento nel calendario specificato. |
delete_event |
Elimina un evento nel calendario specificato. |
respond_to_event |
Risponde a un evento in un calendario. |
search_events |
Cerca gli eventi nel calendario principale dell'utente utilizzando la ricerca semantica. |
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://calendarmcp.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |