MCP Personal Calendar

개인 캘린더 MCP

직접 구축할 수 있는 캘린더 MCP 서비스입니다. 대규모 언어 모델(LLM)이 사용자의 일정과 할 일 목록을 자동으로 관리하도록 할 수 있습니다.

1. 기능

(Caldav 프로토콜 캘린더만 지원하며, 다른 프로토콜 캘린더의 신뢰성은 테스트되지 않았습니다)

1. 지정된 날짜 범위 내의 모든 일정 조회 (모든 캘린더 포함).

2. 지정된 날짜 범위 내의 모든 할 일 조회 (모든 캘린더 포함).

3. 일정 및 할 일 일괄 생성.

   • 위치 정보 추가 지원

   • 지능형 시간대 조정 지원

   • Dify, N8n 등 도구와 결합하여 플랫폼 간 연동 가능

   • 기본적으로 베이징 시간으로 일정 생성

4. 일정 수정 및 삭제 지원.

2. 배포 방법

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시는 베이징 시간 12시에 해당하고, 뉴욕 시간 17시는 베이징 시간 6시에 해당합니다)