Bu, Google Calendar API tarafından sağlanan bir MCP sunucusudur. Sunucu, geliştiricilerin Takvim üzerinde LLM uygulamaları oluşturması için araçlar sağlar.
Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.
Sunucu Kurulumu
Kullanmadan önce Takvim MCP sunucusunu yapılandırmanız gerekir. Google ve Google Cloud uzaktan MCP sunucularını kullanma hakkında daha fazla bilgi için Google Cloud MCP sunucularına genel bakış başlıklı makaleyi inceleyin.
Sunucu Uç Noktaları
MCP hizmeti uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standart bir bağlantı oluşturmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). LLM'nin bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için kullandığı iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.
Takvim MCP API'sinin aşağıdaki genel MCP uç noktası vardır:
- https://calendarmcp.googleapis.com/mcp/v1
MCP Araçları
MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.
Araçlar
calendarmcp.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:
| MCP Araçları | |
|---|---|
list_events |
Belirtilen takvimdeki, belirtilen tüm kısıtlamalarla eşleşen etkinlikleri döndürür. Kullanıcı tarafından istenmediği sürece zaman kısıtlamaları belirtilmemelidir. Birincil takvimde açık uçlu anahtar kelime veya konuya dayalı aramalar için bunun yerine search_events aracı kullanılmalıdır. |
get_event |
Belirtilen takvimdeki tek bir etkinliği döndürür. |
list_calendars |
Bu kullanıcının erişebildiği takvimleri (takvim listesi) döndürür. Takvim tanımlama verilerini (ör. "aile takvimim") karşılık gelen calendar_id (e-posta tanımlayıcısı) ile eşleştirmek için bu aracı kullanın.
|
suggest_time |
Bir veya daha fazla takvimde zaman aralıkları önerir. |
create_event |
Belirtilen takvimde etkinlik oluşturur. |
update_event |
Belirtilen takvimdeki bir etkinliği günceller. |
delete_event |
Belirtilen takvimdeki bir etkinliği siler. |
respond_to_event |
Takvimdeki bir etkinliğe yanıt verir. |
search_events |
Anlamsal aramayı kullanarak kullanıcının birincil takvimindeki etkinlikleri arar. |
MCP aracı özelliklerini alma
Bir MCP sunucusundaki tüm araçların MCP aracı özelliklerini almak için tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.
| Curl İsteği |
|---|
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 }' |