یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل میکند که زمینه، دادهها یا قابلیتهایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم میکند. سرورهای MCP برنامههای هوش مصنوعی را به سیستمهای خارجی مانند پایگاههای داده و سرویسهای وب متصل میکنند و پاسخهای آنها را به فرمتی که برنامه هوش مصنوعی میتواند درک کند، ترجمه میکنند.
ابزارهای MCP
یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار میدهد تا عملی را در دنیای واقعی انجام دهد.
سرور MCP gmailmcp.googleapis.com ابزارهای زیر را دارد:
| ابزارهای MCP | |
|---|---|
| ایجاد_پیشنویس | یک ایمیل پیشنویس جدید در حساب جیمیل کاربر احراز هویتشده ایجاد میکند. این ابزار آدرسهای گیرنده، موضوع و محتوای اصلی ایمیل را به عنوان ورودی دریافت میکند و شناسه پیشنویس جیمیل ایجاد شده را برمیگرداند. |
| فهرست_پیشنویسها | ایمیلهای پیشنویس را از حساب جیمیل کاربر احراز هویتشده فهرست میکند. این ابزار میتواند پیشنویسها را بر اساس یک رشته پرسوجو فیلتر کند و از صفحهبندی پشتیبانی میکند. این ابزار لیستی از پیشنویسها، شامل شناسهها و موضوعات آنها را برمیگرداند. |
| دریافت_موضوع | یک رشته ایمیل خاص را از حساب Gmail کاربر احراز هویت شده، شامل لیستی از پیامهای آن، بازیابی میکند. |
| search_threads | رشتههای ایمیل از حساب Gmail کاربر احراز هویتشده را فهرست میکند. این ابزار میتواند رشتهها را بر اساس یک رشته پرسوجو فیلتر کند و از صفحهبندی پشتیبانی میکند. این ابزار لیستی از رشتهها، شامل شناسههای آنها و پیامهای مرتبط را برمیگرداند. هر پیام مرتبط شامل جزئیاتی مانند بخشی از متن پیام، موضوع، فرستنده، گیرندگان و غیره است. توجه داشته باشید که متن کامل پیام توسط این ابزار برگردانده نمیشود؛ در صورت نیاز از ابزار 'get_thread' با شناسه رشته برای دریافت متن کامل پیام استفاده کنید. |
| label_thread | برچسبها را به کل یک رشته گفتگو در حساب جیمیل کاربر احراز هویت شده اضافه میکند. این عملیات بر تمام پیامهای فعلی در رشته گفتگو و هر پیام بعدی که به آن اضافه شود، تأثیر میگذارد. اگر از شناسهی رشته مطمئن نیستید، ابتدا از ابزار اگر از شناسه برچسب کاربری مطمئن نیستید، ابتدا از ابزار |
| unlabel_thread | برچسبها را از کل یک رشته در حساب جیمیل کاربر احراز هویت شده حذف میکند. اگر از شناسه رشته مطمئن نیستید، ابتدا از ابزار search_threads استفاده کنید. اگر از شناسه برچسب کاربر مطمئن نیستید، ابتدا از ابزار list_labels استفاده کنید. |
| list_labels | تمام برچسبهای تعریفشده توسط کاربر موجود در حساب جیمیل کاربر احراز هویتشده را فهرست میکند. از این ابزار برای کشف id برچسب کاربر قبل از فراخوانی label_thread ، unlabel_thread ، label_message یا unlabel_message استفاده کنید. برچسبهای سیستم توسط این ابزار بازگردانده نمیشوند، اما میتوانند با شناسههای شناختهشدهشان مورد استفاده قرار گیرند: 'INBOX'، 'TRASH'، 'SPAM'، 'STARRED'، 'UNREAD'، 'IMPORTANT'، 'CHAT'، 'DRAFT'، 'SENT'. |
| پیام_برچسب | یک یا چند برچسب به یک پیام خاص در حساب Gmail کاربر احراز هویت شده اضافه میکند. برای یافتن شناسه پیام، از ابزارهایی مانند |
| پیام_بدون_برچسب | یک یا چند برچسب را از یک پیام خاص در حساب Gmail کاربر احراز هویت شده حذف میکند. برای یافتن شناسه پیام، از ابزارهایی مانند search_threads یا get_thread استفاده کنید. اگر از شناسه برچسب کاربر مطمئن نیستید، ابتدا از ابزار list_labels برای کشف برچسبهای موجود و شناسههای آنها استفاده کنید. |
| ایجاد_برچسب | یک برچسب جدید در حساب Gmail کاربر احراز هویت شده ایجاد میکند. |
مشخصات ابزار MCP را دریافت کنید
برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان میدهد.
| درخواست کرل |
|---|
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 }' |