MCP Reference: people.googleapis.com

Model Context Protocol (MCP) 伺服器可做為代理伺服器，在外部服務與大型語言模型 (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
}'