MCP Reference: people.googleapis.com

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

MCP 工具

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

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

MCP 工具
search_directory_people

在您组织的 Google Workspace 目录中搜索人员。此功能仅适用于 Google Workspace 账号(供企业、学校和其他组织使用),不适用于个人 Google 账号。

必须遵守的重要规则

  • 如果此工具返回多个结果,您应向用户显示这些结果,并提示用户说明要使用哪个结果,然后再继续操作。

  • 严禁在未经用户明确确认的情况下,将此工具的输出传递给其他工具(例如,发送电子邮件、创建草稿、创建活动等)。

  • 即使只找到一个人员结果,您也必须向用户显示找到的人员的详细信息,并提示用户验证此人是否是预期的人员,然后再继续执行后续步骤。

  • 如果此工具未返回任何结果,请改用 search_contacts 工具。

search_contacts

搜索用户的联系人。

必须遵守的重要规则

  • 如果此工具返回多个结果,您应向用户显示这些结果,并提示用户说明要使用哪个结果,然后再继续操作。

  • 严禁在未经用户明确确认的情况下,将此工具的输出传递给其他工具(例如,发送电子邮件、创建草稿、创建活动等)。

  • 即使只找到一个人员结果,您也必须向用户显示找到的人员的详细信息,并提示用户验证此人是否是预期的人员,然后再继续执行后续步骤。

get_user_profile 获取有关您自己的个人资料信息(姓名和电子邮件地址)。

获取 MCP 工具规范

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

Curl 请求
curl --location 'https://people.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
}'