Este é um servidor MCP fornecido pela API Google Calendar. O servidor oferece ferramentas para que os desenvolvedores criem aplicativos LLM com base no Calendar.
Um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) ou um aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.
Configuração do servidor
Você precisa configurar o servidor MCP do Calendar antes de usar. Para mais informações sobre como usar servidores MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.
Endpoints do servidor
Um endpoint de serviço MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints MCP do Google podem ser globais ou regionais.
A API MCP do Calendar tem o seguinte endpoint MCP global:
- https://calendarmcp.googleapis.com/mcp/v1
Ferramentas do MCP
Uma ferramenta MCP é uma função ou capacidade executável que um servidor MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.
Ferramentas
O servidor MCP calendarmcp.googleapis.com tem as seguintes ferramentas:
| Ferramentas do MCP | |
|---|---|
list_events |
Retorna eventos na agenda especificada que correspondem a todas as restrições especificadas. As restrições de tempo não devem ser especificadas, a menos que solicitadas pelo usuário. Para pesquisas de palavras-chave ou tópicos abertos na agenda principal, a ferramenta search_events precisa ser usada. |
get_event |
Retorna um único evento na agenda especificada. |
list_calendars |
Retorna as agendas a que esse usuário tem acesso (a lista de agendas dele). Use essa ferramenta para resolver dados de identificação da agenda (por exemplo, "minha agenda da família") no calendar_id correspondente (identificador de e-mail).
|
suggest_time |
Sugere períodos em uma ou mais agendas. |
create_event |
Cria um evento na agenda especificada. |
update_event |
Atualiza um evento na agenda especificada. |
delete_event |
Exclui um evento na agenda especificada. |
respond_to_event |
Responde a um evento em uma agenda. |
search_events |
Pesquisa eventos na agenda principal do usuário usando a pesquisa semântica. |
Receber especificações da ferramenta MCP
Para receber as especificações da ferramenta MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no momento no servidor MCP.
| Solicitação 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 }' |