MCP Personal Calendar

Persönlicher Kalender MCP

Dies ist ein selbst gehosteter Kalender-MCP-Dienst. Er ermöglicht es großen Sprachmodellen, Ihre Termine und Aufgaben automatisch zu verwalten.

I. Funktionen

(Unterstützt nur CalDAV-Protokoll-Kalender; die Zuverlässigkeit anderer Kalenderprotokolle wurde nicht getestet)

1. Abfrage aller Termine innerhalb eines angegebenen Datumsbereichs (aus allen Kalendern).

2. Abfrage aller Aufgaben innerhalb eines angegebenen Datumsbereichs (aus allen Kalendern).

3. Stapelerstellung von Terminen und Aufgaben.

   • Unterstützung für das Hinzufügen von Standortinformationen

   • Unterstützung für intelligente Zeitzonenanpassungen

   • Kann mit Tools wie Dify, N8n usw. für plattformübergreifende Verknüpfungen kombiniert werden

   • Termine werden standardmäßig in Pekinger Zeit erstellt

4. Unterstützung für das Ändern und Löschen von Terminen.

II. Bereitstellungsmethode

1. Klonen Sie den Quellcode mit dem folgenden Befehl

   git clone https://github.com/Blacol/MCP-PersonalCalendar

2. Erstellen Sie eine config.json-Datei im Verzeichnis des Quellcodes. Hier ist ein Beispiel:

   {
    "calendar_url": "Caldav服务器地址",
    "calendar_username": "日历用户名",
    "calendar_password": "日历密码",
    "default_remind_time": "-15m"
   }

3. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren

   # 先创建一个虚拟环境
   python3 -m venv .venv
   # 进入虚拟环境（Linux）
   source .venv/bin/activate
   # 安装依赖
   uv pip install -e .
   # 运行程序
   uv run main.py

4. Öffnen Sie den MCP-Client und konfigurieren Sie die Informationen

   Diese Software überwacht Port 20002. Denken Sie daran, den entsprechenden Port nach der Bereitstellung auf dem Server freizugeben.

   Konfigurationsinformationen (CherryStudio):

   {
      "mcpServers": {
        "PersonalCalendar": {
          "type": "sse",
          "url": "[服务器公网IP]:20002/sse"
        }
      }
   }

   Konfigurationsinformationen (andere MCP-Clients):

   {
     "transport": "sse",
     "url": "[服务器公网IP]:20002/sse"
   }

5. Öffnen Sie das Modell, um es zu testen

   Mehrere Termine hinzufügen

   帮我把下面几个日程添加到测试用日历中：
   1. 2025年11月4日 13:00-15:00 测试日程1
   2. 2025年11月4日 17:00-22:00 测试日程2
   3. 2025年11月5日 8:00-11:30 测试日程3，地点在A市的B大厦里

   Beispiel

   Termine in verschiedenen Zeitzonen hinzufügen

   帮我把下面几个日程添加到测试用日历中：
   1. 2025年11月4日 13:00-15:00（东京时间） 测试日程1
   2. 2025年11月4日 17:00-22:00（纽约时间） 测试日程2

   Beispiel (Die Software zeigt Termine standardmäßig in Pekinger Zeit an; 13:00 Uhr Tokioter Zeit entspricht 12:00 Uhr Pekinger Zeit, 17:00 Uhr New Yorker Zeit entspricht 06:00 Uhr Pekinger Zeit)