MCP Personal Calendar

MCP для личного календаря

Это сервис MCP для календаря, который можно развернуть самостоятельно. Он позволяет большим языковым моделям автоматически управлять вашим расписанием и списком дел.

I. Функции

(Поддерживаются только календари протокола CalDAV, надежность календарей с другими протоколами не тестировалась)

1. Поиск всех событий в указанном диапазоне дат (во всех календарях).

2. Поиск всех задач в указанном диапазоне дат (во всех календарях).

3. Пакетное создание событий и задач.

   • Поддержка добавления информации о местоположении

   • Поддержка интеллектуальной настройки часовых поясов

   • Возможность интеграции с Dify, N8n и другими инструментами для кроссплатформенного взаимодействия

   • По умолчанию события создаются по пекинскому времени

4. Поддержка изменения и удаления событий.

II. Способ развертывания

1. Используйте следующую команду для клонирования исходного кода

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

2. Создайте файл config.json в каталоге с исходным кодом, ниже приведен пример:

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

3. Выполните следующую команду для установки зависимостей

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

4. Откройте MCP-клиент и настройте информацию

   Данное ПО прослушивает порт 20002. После развертывания на сервере не забудьте открыть соответствующий порт.

   Конфигурация (CherryStudio):

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

   Конфигурация (другие MCP-клиенты):

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

5. Откройте модель для тестирования

   Добавление нескольких событий

   帮我把下面几个日程添加到测试用日历中：
   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大厦里

   Пример

   Добавление событий в разных часовых поясах

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

   Пример (В программе события по умолчанию отображаются по пекинскому времени: 13:00 по токийскому времени соответствует 12:00 по пекинскому, а 17:00 по нью-йоркскому времени соответствует 06:00 по пекинскому)