این یک سرور MCP است که توسط Google Calendar API ارائه شده است. این سرور ابزارهایی را برای توسعهدهندگان فراهم میکند تا برنامههای LLM را بر اساس تقویم بسازند.
یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل میکند که زمینه، دادهها یا قابلیتهایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم میکند. سرورهای MCP برنامههای هوش مصنوعی را به سیستمهای خارجی مانند پایگاههای داده و سرویسهای وب متصل میکنند و پاسخهای آنها را به فرمتی که برنامه هوش مصنوعی میتواند درک کند، ترجمه میکنند.
راه اندازی سرور
قبل از استفاده، باید سرور Calendar MCP را پیکربندی کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای Google Cloud MCP مراجعه کنید.
نقاط پایانی سرور
یک نقطه پایانی سرویس MCP، آدرس شبکه و رابط ارتباطی (معمولاً یک URL) سرور MCP است که یک برنامه هوش مصنوعی (میزبان برای کلاینت MCP) برای ایجاد یک اتصال امن و استاندارد از آن استفاده میکند. این نقطه تماس LLM برای درخواست زمینه، فراخوانی یک ابزار یا دسترسی به یک منبع است. نقاط پایانی Google MCP میتوانند جهانی یا منطقهای باشند.
API تقویم MCP دارای نقطه پایانی MCP سراسری زیر است:
- https://calendarmcp.googleapis.com/mcp/v1
ابزارهای MCP
یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار میدهد تا عملی را در دنیای واقعی انجام دهد.
ابزارها
سرور MCP calendarmcp.googleapis.com ابزارهای زیر را دارد:
| ابزارهای MCP | |
|---|---|
list_events | رویدادهایی را در تقویم داده شده که با تمام محدودیتهای مشخص شده مطابقت دارند، برمیگرداند. محدودیتهای زمانی نباید مشخص شوند، مگر اینکه توسط کاربر درخواست شده باشد. برای جستجوهای کلیدواژهای یا موضوعی بدون پایان در تقویم اصلی، باید از ابزار search_events استفاده شود. |
get_event | یک رویداد واحد را در تقویم داده شده برمیگرداند. |
list_calendars | تقویمهایی را که این کاربر به آنها دسترسی دارد (لیست تقویمهایش) برمیگرداند. از این ابزار برای تبدیل دادههای شناسایی تقویم (مثلاً «تقویم خانوادگی من») به calendar_id (شناسه ایمیل) مربوطه استفاده کنید. |
suggest_time | دورههای زمانی را در یک یا چند تقویم پیشنهاد میدهد. |
create_event | یک رویداد در تقویم داده شده ایجاد میکند. |
update_event | یک رویداد را در تقویم داده شده بهروزرسانی میکند. |
delete_event | یک رویداد را در تقویم داده شده حذف میکند. |
respond_to_event | به یک رویداد در تقویم پاسخ میدهد. |
search_events | با استفاده از جستجوی معنایی، رویدادهای تقویم اصلی کاربر را جستجو میکند. |
مشخصات ابزار MCP را دریافت کنید
برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان میدهد.
| درخواست کرل |
|---|
curl --location 'https://calendarmcp.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 }' |