MCP Reference: people.googleapis.com

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

people.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
search_directory_people

組織の Google Workspace ディレクトリ内のユーザーを検索します。この機能は Google Workspace アカウント（企業、学校、その他の組織で使用）専用であり、個人の Google アカウントではご利用いただけません。

重要なルール:

  • このツールから複数の結果が返された場合は、ユーザーに結果を提示し、どの結果を使用するかを明確にするようユーザーに促してから続行する必要があります。

  • ユーザーの明示的な確認なしに、このツールの出力を別のツールに渡す（メールの送信、下書きの作成、予定の作成など）ことは固く禁じられています。

  • 人物の結果が 1 つしか見つからなかった場合でも、見つかった人物の詳細をユーザーに提示し、ユーザーにその人物が目的の人物であることを確認するよう促してから、次の手順に進む必要があります。

  • このツールで結果が返されない場合は、search_contacts ツールを使用します。
search_contacts

ユーザーの連絡先を検索します。

重要なルール:

  • このツールから複数の結果が返された場合は、ユーザーに結果を提示し、どの結果を使用するかを明確にするようユーザーに促してから続行する必要があります。

  • ユーザーの明示的な確認なしに、このツールの出力を別のツールに渡す（メールの送信、下書きの作成、予定の作成など）ことは固く禁じられています。

  • 人物の結果が 1 つしか見つからなかった場合でも、見つかった人物の詳細をユーザーに提示し、ユーザーにその人物が目的の人物であることを確認するよう促してから、次の手順に進む必要があります。
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
}'