MCP Reference: gmailmcp.googleapis.com

يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.

أدوات MCP

أداة MCP هي وظيفة أو إمكانية تنفيذية يعرضها خادم MCP لتطبيق LLM أو تطبيق مستند إلى الذكاء الاصطناعي من أجل تنفيذ إجراء في العالم الحقيقي.

يتضمّن خادم MCP على gmailmcp.googleapis.com الأدوات التالية:

أدوات MCP
create_draft

تُنشئ هذه الطريقة مسودة رسالة إلكترونية جديدة في حساب Gmail الخاص بالمستخدم الذي تمّت المصادقة عليه.

تتلقّى هذه الأداة عناوين المستلِمين والموضوع ومحتوى الرسالة كمدخلات. تعرض هذه الطريقة رقم تعريف مسودة Gmail التي تم إنشاؤها.
list_drafts

تعرض هذه الطريقة قائمة بالرسائل الإلكترونية المحفوظة كمسودّة من حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته.

يمكن لهذه الأداة فلترة المسودات استنادًا إلى سلسلة طلب بحث وتتيح تقسيم المحتوى إلى صفحات. تعرض هذه الطريقة قائمة بالمسودات، بما في ذلك معرّفاتها ومواضيعها.
get_thread يسترد سلسلة محادثات بريد إلكتروني معيّنة من حساب Gmail الخاص بالمستخدم الذي تمّت المصادقة عليه، بما في ذلك قائمة برسائله.
search_threads

تعرض هذه الطريقة سلاسل الرسائل الإلكترونية من حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته.

يمكن لهذه الأداة فلترة سلاسل المحادثات استنادًا إلى سلسلة طلب بحث وتتيح تقسيم المحتوى إلى صفحات. تعرض هذه الطريقة قائمة بسلاسل المحادثات، بما في ذلك أرقام التعريف والرسائل ذات الصلة. تحتوي كل رسالة ذات صلة على تفاصيل مثل مقتطف من نص الرسالة والموضوع والمُرسِل والمستلِمين وما إلى ذلك. يُرجى العِلم أنّ هذه الأداة لا تعرض نصوص الرسائل الكاملة، لذا استخدِم الأداة get_thread مع رقم تعريف سلسلة المحادثات لاسترداد نص الرسالة الكامل إذا لزم الأمر.
label_thread

تضيف هذه الطريقة تصنيفات إلى سلسلة محادثات كاملة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته. يؤثر هذا الإجراء في جميع الرسائل الحالية في سلسلة المحادثات وأي رسائل مستقبلية تُضاف إليها.

إذا لم تكن متأكدًا من رقم تعريف سلسلة المحادثات، استخدِم الأداة search_threads أولاً.

في حال عدم التأكّد من رقم تعريف تصنيف مستخدم، استخدِم الأداة list_labels أولاً للتعرّف على التصنيفات المتاحة وأرقام تعريفها.
unlabel_thread يزيل هذا الإجراء التصنيفات من سلسلة محادثات كاملة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته. إذا لم تكن متأكدًا من رقم تعريف سلسلة المحادثات، استخدِم الأداة search_threads أولاً. إذا لم تكن متأكدًا من رقم تعريف تصنيف المستخدم، استخدِم الأداة list_labels أولاً.
list_labels تعرض هذه الطريقة جميع التصنيفات التي يحدّدها المستخدم والمتاحة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته. استخدِم هذه الأداة لاكتشاف id لتصنيف مستخدم قبل طلب label_thread أو unlabel_thread أو label_message أو unlabel_message. لا تعرض هذه الأداة تصنيفات النظام، ولكن يمكن استخدامها مع أرقام التعريف المعروفة: INBOX وTRASH وSPAM وSTARRED وUNREAD وIMPORTANT وCHAT وDRAFT وSENT.
label_message

تضيف هذه الطريقة تصنيفًا واحدًا أو أكثر إلى رسالة محدّدة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته.

للعثور على معرّف الرسالة، استخدِم أدوات مثل search_threads أو get_thread. في حال عدم التأكّد من رقم تعريف تصنيف مستخدم، استخدِم الأداة list_labels أولاً للتعرّف على التصنيفات المتاحة وأرقام تعريفها.
unlabel_message يزيل تصنيفًا واحدًا أو أكثر من رسالة محدّدة في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته. للعثور على معرّف الرسالة، استخدِم أدوات مثل search_threads أو get_thread. في حال عدم التأكّد من رقم تعريف تصنيف مستخدم، استخدِم الأداة list_labels أولاً للتعرّف على التصنيفات المتاحة وأرقام تعريفها.
create_label تنشئ هذه الطريقة تصنيفًا جديدًا في حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته.

التعرّف على مواصفات أداة MCP

للحصول على مواصفات أداة MCP لجميع الأدوات في خادم MCP، استخدِم طريقة tools/list. يوضّح المثال التالي كيفية استخدام curl لإدراج جميع الأدوات ومواصفاتها المتاحة حاليًا في خادم MCP.

طلب Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'