هذا خادم MCP توفّره Google Calendar API. يوفّر الخادم أدوات للمطوّرين لإنشاء تطبيقات نماذج اللغات الكبيرة (LLM) استنادًا إلى "تقويم Google".
يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بأنظمة خارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.
إعداد الخادم
يجب ضبط إعدادات خادم MCP في "تقويم Google" قبل الاستخدام. لمزيد من المعلومات حول استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP في Google Cloud.
نقاط نهاية الخادم
نقطة نهاية خدمة MCP هي عنوان الشبكة وواجهة الاتصال (عادةً ما تكون عنوان URL) لخادم MCP الذي يستخدمه تطبيق مستند إلى الذكاء الاصطناعي (المضيف لبرنامج MCP) لإنشاء اتصال آمن وموحّد. وهي نقطة التواصل التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استخدام أداة أو الوصول إلى مرجع. يمكن أن تكون نقاط نهاية Google MCP عالمية أو إقليمية.
تحتوي واجهة برمجة التطبيقات Calendar MCP API على نقطة نهاية MCP العامة التالية:
- https://calendarmcp.googleapis.com/mcp/v1
أدوات MCP
أداة MCP هي وظيفة أو إمكانية تنفيذية يعرضها خادم MCP لنموذج لغوي كبير أو تطبيق ذكاء اصطناعي لتنفيذ إجراء في العالم الحقيقي.
الأدوات
يتضمّن خادم 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 |
|---|
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 }' |