MCP Reference: people.googleapis.com

سرور MCP API افراد

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

راه اندازی سرور

قبل از استفاده، باید سرور People API MCP را پیکربندی کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای Google Cloud MCP مراجعه کنید.

نقاط پایانی سرور

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

سرور MCP مربوط به People API دارای نقطه پایانی MCP سراسری زیر است:

  • https://people.googleapis.com/mcp/v1

سرور People API MCP، ابزار MCP زیر را ارائه می‌دهد:

  • https://people.googleapis.com/mcp/v1

ابزارهای MCP

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

مجموعه ابزارها

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

مجموعه ابزارهای MCP
نقطه پایانی توضیحات ابزارها
/mcp/v1 ابزارهای MCP برای API افراد
  • جستجوی_دایرکتوری_افراد
  • جستجوی_مخاطبین
  • دریافت_پروفایل_کاربر
  • مشخصات ابزار 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
    }'