MCP Reference: calendarmcp.googleapis.com

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

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

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

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

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

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

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

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

এমসিপি টুলস

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

সরঞ্জাম

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

এমসিপি টুলস
list_events

প্রদত্ত ক্যালেন্ডারে থাকা নির্দিষ্ট শর্ত পূরণকারী ইভেন্টগুলোর তালিকা তৈরি করে।

প্রধান বৈশিষ্ট্য:

  • যেকোনো ক্যালেন্ডার আইডি, যা ব্যবহারকারীর প্রাথমিক ক্যালেন্ডার বা অন্য কোনো ক্যালেন্ডার হতে পারে।
  • কীওয়ার্ড মেলানো।
  • সময়সীমা ফিল্টারিং।
  • সময় এবং কীওয়ার্ডের শর্ত পূরণকারী সমস্ত ইভেন্ট পুনরুদ্ধার করে।

এর পরিবর্তে search_events টুলটি ব্যবহার করুন যদি:

  • শর্তগুলো পূরণকারী সমস্ত ঘটনার পরিবর্তে, আপনাকে সর্বাধিক প্রাসঙ্গিক (শীর্ষ K) ঘটনাগুলো খুঁজে বের করতে হবে।
  • আপনার শব্দার্থিক অনুসন্ধান ক্ষমতা প্রয়োজন।
  • আপনি নির্দিষ্ট তথ্যের জন্য শুধুমাত্র ব্যবহারকারীর প্রাথমিক ক্যালেন্ডারটি অনুসন্ধান করছেন।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • আগামীকাল আমার ক্যালেন্ডারে কী আছে?
  • ২০২৫ সালের ১৪ই জুলাই আমার ক্যালেন্ডারে কী কী দিন নির্ধারিত আছে?
  • আগামী সপ্তাহে আমার কী কী মিটিং আছে?
  • আজ বিকেলে আমার কি কোনো সমস্যা আছে?

উদাহরণ:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.
get_event

প্রদত্ত ক্যালেন্ডার থেকে একটিমাত্র ইভেন্ট ফেরত দেয়।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • টিম মিটিংয়ের বিস্তারিত তথ্য জেনে নিন।
  • আমার ক্যালেন্ডারে event123 আইডিযুক্ত ইভেন্টটি দেখান।

উদাহরণ:

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
list_calendars

ব্যবহারকারীর ক্যালেন্ডার তালিকায় থাকা ক্যালেন্ডারগুলো ফেরত দেয়।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • আমার সব ক্যালেন্ডারগুলো কী কী?

উদাহরণ:

list_calendars()
# Returns all calendars the authenticated user has access to.
suggest_time

এক বা একাধিক ক্যালেন্ডার জুড়ে সময়কাল প্রস্তাব করে। প্রাথমিক ক্যালেন্ডারটি অ্যাক্সেস করতে, attendee_emails ফিল্ডে 'primary' যোগ করুন।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • মিটিংয়ের জন্য আমরা সবাই কখন ফ্রি থাকব?
  • ৩০ মিনিটের এমন একটা সময় খুঁজে বের করুন যখন আমরা দুজনেই উপস্থিত থাকতে পারব।
  • সোমবার সকালে jane.doe@google.com ফ্রি আছে কিনা দেখুন।

উদাহরণ:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.
create_event

একটি ক্যালেন্ডার ইভেন্ট তৈরি করে।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • আমার ক্যালেন্ডারে আগামীকাল দুপুর ২টোর জন্য 'জেনের সাথে মিটিং' নামে একটি ইভেন্ট তৈরি করুন।
  • আগামী সোমবার সকাল ১০টা থেকে ১১টার মধ্যে john.doe@google.com- এর সাথে একটি মিটিং নির্ধারণ করুন।

উদাহরণ:

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
update_event

ক্যালেন্ডারের একটি ইভেন্ট আপডেট করে।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • 'জেনের সাথে সাক্ষাৎ' ইভেন্টটি এক ঘণ্টা পরে আপডেট করুন।
  • আগামীকালের মিটিংয়ে john.doe@google.com- কে যুক্ত করুন।

উদাহরণ:

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.
delete_event

ক্যালেন্ডারের একটি ইভেন্ট মুছে ফেলে।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • আমার ক্যালেন্ডার থেকে event123 আইডিযুক্ত ইভেন্টটি মুছে ফেলুন।

কোনো ইভেন্ট বাতিল বা প্রত্যাখ্যান করতে, এর পরিবর্তে respond_to_event টুলটি ব্যবহার করুন।

উদাহরণ:

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
respond_to_event

কোনো ঘটনার প্রতিক্রিয়া জানায়।

এই ধরনের কোয়েরির জন্য এই টুলটি ব্যবহার করুন:

  • আমার ক্যালেন্ডারে event123 আইডিযুক্ত ইভেন্টটি গ্রহণ করুন।
  • জেনের সাথে বৈঠকটি প্রত্যাখ্যান করুন।
  • আমার পরবর্তী মিটিংটি বাতিল করুন।
  • পরিকল্পনা সভাটি প্রাথমিকভাবে গ্রহণ করুন।

উদাহরণ:

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.

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

একটি 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
}'