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