MCP Reference: calendarmcp.googleapis.com

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

এমসিপি টুলস

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

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

এমসিপি টুলস
তালিকা_ইভেন্ট

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

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

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

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

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

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

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

উদাহরণ:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=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(
    event_id='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
ক্যালেন্ডারের তালিকা

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

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

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

উদাহরণ:

list_calendars()
# Returns all calendars the authenticated user has access to.
পরামর্শ_সময়

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

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

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

উদাহরণ:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': 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.
ইভেন্ট তৈরি করুন

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

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

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

উদাহরণ:

create_event(
    summary='Meeting with Jane',
    start_time='2024-09-17T14:00:00',
    end_time='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
আপডেট_ইভেন্ট

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

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

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

উদাহরণ:

update_event(
    event_id='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'.
ডিলিট_ইভেন্ট

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

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

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

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

উদাহরণ:

delete_event(
    event_id='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
ইভেন্টে সাড়া দিন

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

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

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

উদাহরণ:

respond_to_event(
    event_id='event123',
    response_status='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' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'