MCP

🚀 MCPカレンダーサーバ

代数的データ型(ADT)をベースとした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

💻 使用例

基本的な使用法

イベントの作成

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)

📚 ドキュメント

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

🔧 技術詳細

開発

テストの実行

uv run pytest

コードのフォーマット

uv run black src/
uv run ruff check src/

📄 ライセンス

このプロジェクトはMITライセンスの下で配布されています。