MCP Calendar Server

MCP 캘린더 서버

ADT(Algebraic Data Type) 기반의 MCP 캘린더 관리 시스템입니다.

개요

이 프로젝트는 Model Context Protocol(MCP)을 사용하여 캘린더 이벤트를 관리하는 서버입니다. 함수형 프로그래밍 패러다임과 ADT를 적용하여 타입 안전성과 예측 가능성을 보장합니다.

주요 기능

✅ 캘린더 이벤트 CRUD 작업
✅ 카테고리별 이벤트 분류 (학습, 업무, 휴식, 활동)
✅ 이벤트 상태 관리 (계획됨, 완료됨, 취소됨)
✅ 스태미나 시스템 통합
✅ 시간 충돌 방지
✅ 날짜별/카테고리별 이벤트 조회

설치 및 실행

요구사항

Python 3.10+
uv 패키지 매니저

설치

# 의존성 설치
uv sync

# 개발 의존성 포함 설치
uv sync --extra dev

실행

# MCP 서버 실행
uv run python main.py

# 또는 직접 실행
uv run python src/main.py

API 도구 (Tools)

1. get_all_events()

모든 캘린더 이벤트를 조회합니다.

2. get_event_by_id(event_id: int)

특정 ID의 이벤트를 조회합니다.

3. create_calendar_event(...)

새로운 캘린더 이벤트를 생성합니다.

매개변수:

title: 이벤트 제목
start_time: 시작 시간 (ISO 형식: 2025-08-02T10:00:00)
duration: 지속 시간(분)
category: 카테고리 (STUDY, WORK, REST, ACTIVITY)
description: 이벤트 설명 (선택)
location: 장소 (선택)
stamina_cost: 스태미나 소모량 (기본값: 0)

4. update_calendar_event(event_id: int, ...)

기존 이벤트를 수정합니다.

5. delete_calendar_event(event_id: int)

이벤트를 삭제합니다.

6. complete_event(event_id: int, stamina_after: int)

이벤트를 완료 상태로 변경합니다.

7. get_events_by_category(category: str)

카테고리별로 이벤트를 조회합니다.

8. get_events_by_date(date: str)

특정 날짜의 이벤트를 조회합니다.

데이터 모델

EventCategory

STUDY: 학습
WORK: 업무
REST: 휴식
ACTIVITY: 활동

EventStatus

PLANNED: 계획됨
COMPLETED: 완료됨
CANCELED: 취소됨

CalendarEvent

캘린더 이벤트의 핵심 엔티티로 다음 필드를 포함합니다:

ID, 사용자 ID, 제목, 설명, 장소
시작 시간, 지속 시간, 카테고리
스태미나 소모량, 상태, 완료 후 스태미나
생성 시간

프로젝트 구조

ittae-MCP/
├── src/
│   ├── __init__.py
│   ├── main.py                 # MCP 서버 메인
│   ├── models/
│   │   └── __init__.py         # 데이터 모델 정의
│   ├── services/
│   │   ├── __init__.py
│   │   └── calendar_service.py # 비즈니스 로직
│   └── exceptions/
│       └── __init__.py         # 예외 처리
├── tests/                      # 테스트 파일
├── main.py                     # 진입점
├── pyproject.toml             # 프로젝트 설정
└── README.md

사용 예시

이벤트 생성

create_calendar_event(
    title="팀 미팅",
    start_time="2025-08-02T10:00:00",
    duration=60,
    category="WORK",
    description="주간 팀 미팅",
    location="회의실 A",
    stamina_cost=20
)

날짜별 이벤트 조회

get_events_by_date("2025-08-02")

이벤트 완료 처리

complete_event(event_id=1, stamina_after=80)

개발

테스트 실행

uv run pytest

코드 포맷팅

uv run black src/
uv run ruff check src/

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

Tools

An ADT-based calendar management system that enables users to create, update, and organize events by category with integrated stamina tracking functionality.

Related MCP Servers

Calendar Tools MCP Server
cablate
-
security
A
license
-
quality
Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
Last updated -
9
2
TypeScript
MIT License
Eventbrite MCP Server
vishalsachdev
-
security
A
license
-
quality
Integrates with the Eventbrite API to provide AI-assisted event management capabilities for viewing events, tracking attendees, and generating analytics reports.
Last updated -
3
1
MIT License
Personal Assistant MCP Server
lemannrus
-
security
F
license
-
quality
A unified interface for managing digital life through integrations with Google Calendar, Obsidian Vault, Trello, and web page parsing capabilities.
Last updated -
3
Python
Dooray MCP Server
mskim8717
-
security
A
license
-
quality
A server that enables management of schedules through the Dooray API, allowing users to add events with automated time settings and support for location and description information.
Last updated -
1
Python
MIT License

View all related MCP servers