MCP Reference: people.googleapis.com

یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل می‌کند که زمینه، داده‌ها یا قابلیت‌هایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم می‌کند. سرورهای MCP برنامه‌های هوش مصنوعی را به سیستم‌های خارجی مانند پایگاه‌های داده و سرویس‌های وب متصل می‌کنند و پاسخ‌های آنها را به فرمتی که برنامه هوش مصنوعی می‌تواند درک کند، ترجمه می‌کنند.

ابزارهای MCP

یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار می‌دهد تا عملی را در دنیای واقعی انجام دهد.

سرور MCP مربوط به people.googleapis.com ابزارهای زیر را دارد:

ابزارهای MCP
جستجوی_دایرکتوری_افراد

جستجوی افراد در فهرست Google Workspace سازمان شما. این ویژگی منحصراً برای حساب‌های Google Workspace (مورد استفاده توسط مشاغل، مدارس و سایر سازمان‌ها) است و برای حساب‌های شخصی گوگل در دسترس نیست.

قوانین مهمی که باید رعایت شوند:

  • اگر این ابزار چندین نتیجه را برگرداند، باید نتایج را به کاربر ارائه دهید و قبل از ادامه، از او بخواهید که توضیح دهد از کدام نتیجه استفاده کند.

  • شما اکیداً مجاز به انتقال خروجی این ابزار به ابزار دیگری (مثلاً ارسال ایمیل، ایجاد پیش‌نویس، ایجاد رویداد و غیره) بدون تأیید صریح کاربر نیستید.

  • حتی اگر فقط یک نتیجه برای یک نفر پیدا شود، باید جزئیات فرد پیدا شده را به کاربر ارائه دهید و از کاربر بخواهید قبل از ادامه مراحل، تأیید کند که این همان فرد مورد نظر است.

  • اگر این ابزار هیچ نتیجه‌ای برنگرداند، به استفاده از ابزار search_contacts برگردید.

جستجوی_مخاطبین

جستجوی مخاطبین کاربر.

قوانین مهمی که باید رعایت شوند:

  • اگر این ابزار چندین نتیجه را برگرداند، باید نتایج را به کاربر ارائه دهید و قبل از ادامه، از او بخواهید که توضیح دهد از کدام نتیجه استفاده کند.

  • شما اکیداً مجاز به انتقال خروجی این ابزار به ابزار دیگری (مثلاً ارسال ایمیل، ایجاد پیش‌نویس، ایجاد رویداد و غیره) بدون تأیید صریح کاربر نیستید.

  • حتی اگر فقط یک نتیجه برای یک نفر پیدا شود، باید جزئیات فرد پیدا شده را به کاربر ارائه دهید و از کاربر بخواهید قبل از ادامه مراحل، تأیید کند که این همان فرد مورد نظر است.

دریافت_پروفایل_کاربر اطلاعات پروفایل خود (نام و ایمیل) را دریافت کنید.

مشخصات ابزار MCP را دریافت کنید

برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان می‌دهد.

درخواست کرل 
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
}'