MCP Reference: calendarmcp.googleapis.com

这是 Google Calendar API 提供的 MCP 服务器。该服务器为开发者提供了在日历之上构建 LLM 应用的工具。

Model Context Protocol (MCP) 服务器充当外部服务(为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能)与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统,并将这些系统的响应转换为 AI 应用可理解的格式。

服务器设置

您必须先配置日历 MCP 服务器,然后才能使用。如需详细了解如何使用 Google 和 Google Cloud 远程 MCP 服务器,请参阅 Google Cloud MCP 服务器概览

服务器端点

MCP 服务端点是 MCP 服务器的网络地址和通信接口(通常是网址),AI 应用(MCP 客户端的宿主)使用该端点来建立安全、标准化的连接。它是 LLM 请求上下文、调用工具或访问资源的交互点。Google MCP 端点可以是全球性的,也可以是区域性的。

Calendar MCP API 具有以下全局 MCP 端点:

  • https://calendarmcp.googleapis.com/mcp/v1

MCP 工具

MCP 工具是 MCP 服务器向 LLM 或 AI 应用公开的函数或可执行功能,用于在现实世界中执行操作。

工具

calendarmcp.googleapis.com MCP 服务器具有以下工具:

MCP 工具
list_events 返回指定日历中与所有指定限制条件匹配的活动。除非用户要求,否则不应指定时间限制。对于主日历上基于开放式关键字或主题的搜索,必须改用 search_events 工具。
get_event 返回指定日历上的单个活动。
list_calendars 返回相应用户有权访问的日历(即用户的日历列表)。使用此工具将日历标识数据(例如“我的家庭日历”)解析为相应的 calendar_id(电子邮件标识符)
suggest_time 建议一个或多个日历中的时间段。
create_event 在指定日历上创建活动。
update_event 更新指定日历中的活动。
delete_event 删除指定日历中的活动。
respond_to_event 回复日历中的活动。
search_events 使用语义搜索功能搜索用户主日历中的活动。

获取 MCP 工具规范

如需获取 MCP 服务器中所有工具的 MCP 工具规范,请使用 tools/list 方法。下面的示例演示了如何使用 curl 列出 MCP 服务器中当前可用的所有工具及其规范。

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
}'