Jest to serwer MCP udostępniany przez interfejs Google Calendar API. Serwer udostępnia programistom narzędzia do tworzenia aplikacji LLM na podstawie Kalendarza.
Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub możliwości dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.
Konfiguracja serwera
Przed użyciem musisz skonfigurować serwer MCP Kalendarza. Więcej informacji o korzystaniu z serwerów MCP Google i Google Cloud znajdziesz w artykule Omówienie serwerów MCP Google Cloud.
Punkty końcowe serwera
Punkt końcowy usługi MCP to adres sieciowy i interfejs komunikacyjny (zwykle adres URL) serwera MCP, którego aplikacja AI (host klienta MCP) używa do nawiązywania bezpiecznego, standardowego połączenia. Jest to punkt kontaktowy, w którym LLM może poprosić o kontekst, wywołać narzędzie lub uzyskać dostęp do zasobu. Punkty końcowe MCP Google mogą być globalne lub regionalne.
Interfejs Calendar MCP API ma ten globalny punkt końcowy MCP:
- https://calendarmcp.googleapis.com/mcp/v1
Narzędzia MCP
Narzędzie MCP to funkcja lub możliwość wykonywania, którą serwer MCP udostępnia LLM lub aplikacji AI w celu wykonania działania w świecie rzeczywistym.
Narzędzia
Serwer MCP calendarmcp.googleapis.com ma te narzędzia:
| Narzędzia MCP | |
|---|---|
list_events |
Zwraca wydarzenia w danym kalendarzu, które spełniają wszystkie określone ograniczenia. Ograniczenia czasowe nie powinny być określane, chyba że poprosi o to użytkownik. W przypadku wyszukiwania w kalendarzu głównym na podstawie słów kluczowych lub tematów bez ograniczeń należy użyć narzędzia search_events. |
get_event |
Zwraca pojedyncze wydarzenie w danym kalendarzu. |
list_calendars |
Zwraca kalendarze, do których ten użytkownik ma dostęp (listę kalendarzy). Użyj tego narzędzia, aby przekształcić dane identyfikujące kalendarz (np. „mój kalendarz rodzinny”) w odpowiadający mu calendar_id (identyfikator e-mail).
|
suggest_time |
Sugeruje okresy w jednym lub kilku kalendarzach. |
create_event |
Tworzy wydarzenie w danym kalendarzu. |
update_event |
Aktualizuje wydarzenie w danym kalendarzu. |
delete_event |
Usuwa wydarzenie w danym kalendarzu. |
respond_to_event |
Odpowiada na wydarzenie w kalendarzu. |
search_events |
Wyszukuje wydarzenia w kalendarzu głównym użytkownika za pomocą wyszukiwania semantycznego. |
Pobieranie specyfikacji narzędzi MCP
Aby pobrać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak użyć curl, aby wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.
| Żądanie Curl |
|---|
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 }' |