MCP Reference: workspacemcp.googleapis.com

این یک سرور MCP است که توسط Workspace API ارائه شده است. این سرور ابزارهایی را برای توسعه‌دهندگان فراهم می‌کند تا برنامه‌های مدل زبانی بزرگ را روی Workspace (‏Drive،‏ Gmail، «تقویم»، و Chat) بسازند.

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

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

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

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

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

سرور MCP مربوط به Workspace MCP API نقطه‌های پایانی مجموعه ابزار MCP زیر را ارائه می‌دهد:

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

ابزارهای «پروتکل زمینه‌ای مدل» (MCP)

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

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

سرور MCP‏ workspacemcp.googleapis.com دارای مجموعه‌ابزارهای زیر است:

مجموعه ابزارهای MCP
نقطه پایانی شرح ابزارها
/mcp/v1 مجموعه ابزار عمومی برای MCP در Workspace.

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

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

درخواست Curl
curl --location 'https://workspacemcp.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
}'