MCP Reference: gmailmcp.googleapis.com

এটি জিমেইল এপিআই দ্বারা প্রদত্ত একটি এমসিপি সার্ভার। এই সার্ভারটি ডেভেলপারদের জিমেইলের উপর ভিত্তি করে এলএলএম অ্যাপ্লিকেশন তৈরি করার জন্য বিভিন্ন টুল সরবরাহ করে।

একটি মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার, লার্জ ল্যাঙ্গুয়েজ মডেল (LLM) বা এআই অ্যাপ্লিকেশনকে কনটেক্সট, ডেটা বা সক্ষমতা প্রদানকারী কোনো বাহ্যিক পরিষেবার সাথে প্রক্সি হিসেবে কাজ করে। MCP সার্ভারগুলো এআই অ্যাপ্লিকেশনগুলোকে ডেটাবেস এবং ওয়েব সার্ভিসের মতো বাহ্যিক সিস্টেমের সাথে সংযুক্ত করে এবং তাদের প্রতিক্রিয়াগুলোকে এমন একটি ফরম্যাটে অনুবাদ করে যা এআই অ্যাপ্লিকেশনটি বুঝতে পারে।

সার্ভার সেটআপ

ব্যবহারের পূর্বে আপনাকে অবশ্যই জিমেইল এমসিপি সার্ভার কনফিগার করতে হবে। গুগল এবং গুগল ক্লাউড রিমোট এমসিপি সার্ভার ব্যবহার সম্পর্কে আরও তথ্যের জন্য, গুগল ক্লাউড এমসিপি সার্ভার ওভারভিউ দেখুন।

সার্ভার এন্ডপয়েন্ট

একটি এমসিপি সার্ভিস এন্ডপয়েন্ট হলো এমসিপি সার্ভারের নেটওয়ার্ক অ্যাড্রেস এবং কমিউনিকেশন ইন্টারফেস (সাধারণত একটি ইউআরএল), যা একটি এআই অ্যাপ্লিকেশন (এমসিপি ক্লায়েন্টের হোস্ট) একটি সুরক্ষিত ও মানসম্মত সংযোগ স্থাপনের জন্য ব্যবহার করে। এলএলএম-এর জন্য কনটেক্সট অনুরোধ করতে, কোনো টুল চালু করতে বা কোনো রিসোর্স অ্যাক্সেস করার এটিই হলো যোগাযোগের কেন্দ্রবিন্দু। গুগল এমসিপি এন্ডপয়েন্টগুলো বৈশ্বিক বা আঞ্চলিক হতে পারে।

জিমেইল এপিআই এমসিপি সার্ভারের নিম্নলিখিত গ্লোবাল এমসিপি এন্ডপয়েন্ট রয়েছে:

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

এমসিপি টুলস

এমসিপি টুল হলো এমন একটি ফাংশন বা নির্বাহযোগ্য সক্ষমতা যা একটি এমসিপি সার্ভার বাস্তব জগতে কোনো কাজ সম্পাদন করার জন্য এলএলএম বা এআই অ্যাপ্লিকেশনের কাছে উন্মুক্ত করে।

সরঞ্জাম

gmailmcp.googleapis.com MCP সার্ভারটিতে নিম্নলিখিত টুলগুলো রয়েছে:

এমসিপি টুলস
খসড়া তৈরি করুন

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টে একটি নতুন খসড়া ইমেল তৈরি করে।

এই টুলটি ইনপুট হিসেবে প্রাপকের ঠিকানা, একটি বিষয় এবং মূল বিষয়বস্তু গ্রহণ করে। এটি তৈরি হওয়া জিমেইল ড্রাফটটির আইডি ফেরত দেয়।

তালিকা_খসড়া

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্ট থেকে পাঠানো খসড়া ইমেইলগুলোর তালিকা দেখায়।

এই টুলটি কোয়েরি স্ট্রিং ব্যবহার করে ড্রাফট ফিল্টার করতে পারে এবং এতে পেজিনেশন সুবিধা রয়েছে। এটি ড্রাফটগুলোর আইডি এবং বিষয়সহ একটি তালিকা প্রদান করে।

get_thread প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্ট থেকে একটি নির্দিষ্ট ইমেইল থ্রেড পুনরুদ্ধার করে, যার মধ্যে এর বার্তাগুলোর একটি তালিকাও অন্তর্ভুক্ত থাকে।
অনুসন্ধান থ্রেড

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্ট থেকে ইমেইল থ্রেডগুলোর তালিকা দেখায়।

এই টুলটি কোয়েরি স্ট্রিং ব্যবহার করে থ্রেড ফিল্টার করতে পারে এবং পেজিনেশন সমর্থন করে। এটি থ্রেডগুলোর একটি তালিকা ফেরত দেয়, যার মধ্যে তাদের আইডি এবং সম্পর্কিত বার্তাগুলো অন্তর্ভুক্ত থাকে। প্রতিটি সম্পর্কিত বার্তায় বার্তার মূল অংশের একটি সংক্ষিপ্ত বিবরণ, বিষয়, প্রেরক, প্রাপক ইত্যাদির মতো বিস্তারিত তথ্য থাকে। উল্লেখ্য যে, এই টুলটি বার্তার সম্পূর্ণ মূল অংশ ফেরত দেয় না; প্রয়োজনে সম্পূর্ণ বার্তার মূল অংশটি পাওয়ার জন্য থ্রেড আইডি সহ 'get_thread' টুলটি ব্যবহার করুন।

লেবেল_থ্রেড

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টের একটি সম্পূর্ণ থ্রেডে লেবেল যুক্ত করে। এই প্রক্রিয়াটি থ্রেডটিতে বর্তমানে থাকা সমস্ত বার্তা এবং ভবিষ্যতে এতে যুক্ত হওয়া যেকোনো বার্তার ওপর প্রভাব ফেলে।

থ্রেড আইডি সম্পর্কে নিশ্চিত না হলে, প্রথমে search_threads টুলটি ব্যবহার করুন।

কোনো ব্যবহারকারী লেবেলের আইডি সম্পর্কে নিশ্চিত না হলে, প্রথমে উপলব্ধ লেবেল এবং তাদের আইডি খুঁজে বের করতে list_labels টুলটি ব্যবহার করুন।

লেবেল_থ্রেড প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টের একটি সম্পূর্ণ থ্রেড থেকে লেবেল মুছে ফেলে। থ্রেড আইডি সম্পর্কে নিশ্চিত না হলে, প্রথমে search_threads টুলটি ব্যবহার করুন। কোনো ব্যবহারকারী লেবেলের আইডি সম্পর্কে নিশ্চিত না হলে, প্রথমে list_labels টুলটি ব্যবহার করুন।
তালিকা_লেবেল প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টে উপলব্ধ সমস্ত ব্যবহারকারী-সংজ্ঞায়িত লেবেলের তালিকা দেখায়। label_thread , unlabel_thread , label_message , বা unlabel_message কল করার আগে কোনো ব্যবহারকারী লেবেলের id খুঁজে বের করতে এই টুলটি ব্যবহার করুন। সিস্টেম লেবেলগুলো এই টুল দ্বারা ফেরত দেওয়া হয় না, তবে সেগুলো তাদের সুপরিচিত আইডিগুলো দিয়ে ব্যবহার করা যেতে পারে: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'।
লেবেল_বার্তা

প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টের কোনো নির্দিষ্ট বার্তায় এক বা একাধিক লেবেল যোগ করে।

মেসেজ আইডি খুঁজে বের করতে search_threads বা get_thread মতো টুল ব্যবহার করুন। কোনো ইউজার লেবেলের আইডি সম্পর্কে নিশ্চিত না হলে, প্রথমে list_labels টুলটি ব্যবহার করে উপলব্ধ লেবেল এবং তাদের আইডিগুলো খুঁজে বের করুন।

বার্তা লেবেলবিহীন প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টের কোনো নির্দিষ্ট বার্তা থেকে এক বা একাধিক লেবেল মুছে দেয়। বার্তার আইডি খুঁজে পেতে search_threads বা get_thread মতো টুল ব্যবহার করুন। কোনো ব্যবহারকারী লেবেলের আইডি সম্পর্কে নিশ্চিত না হলে, উপলব্ধ লেবেল এবং তাদের আইডি খুঁজে বের করতে প্রথমে list_labels টুলটি ব্যবহার করুন।
লেবেল তৈরি করুন প্রমাণীকৃত ব্যবহারকারীর জিমেইল অ্যাকাউন্টে একটি নতুন লেবেল তৈরি করে।

এমসিপি টুলের স্পেসিফিকেশন জানুন

একটি MCP সার্ভারের সমস্ত টুলের স্পেসিফিকেশন পেতে, tools/list মেথডটি ব্যবহার করুন। নিম্নলিখিত উদাহরণটি দেখায় কিভাবে curl ব্যবহার করে MCP সার্ভারের মধ্যে বর্তমানে উপলব্ধ সমস্ত টুল এবং তাদের স্পেসিফিকেশন তালিকাভুক্ত করা যায়।

কার্ল অনুরোধ
curl --location 'https://gmailmcp.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
}'