FastMCP Todo List Server

FastMCP Todo List Server

FastMCP で構築された、強力で機能豊富な Todo リストサーバーです。Todo の管理に役立つ包括的なツールを提供します。このサーバーは Claude Desktop と連携し、タスクを効率的に作成、管理、整理できます。

Features

• 豊富な Todo 管理機能：詳細なメタデータを含む Todo の作成、読み取り、更新、削除
• 高度なフィルタリングと並べ替え：ステータス、優先度、タグ、期限などによるフィルタリング
• 検索機能：タイトルと説明による Todo の検索
• 自動バックアップ：データを変更する前に自動でバックアップ
• 手動バックアップ：必要に応じて手動でバックアップを作成
• 統計情報：Todo に関する詳細な統計情報を取得
• データ検証：すべての入力を包括的に検証
• キャッシュ：ファイル I/O を削減する効率的なキャッシュ
• 設定可能：環境変数でファイルパスを設定可能

Installation

1. このリポジトリをクローンします：

   git clone https://github.com/DustyPolk/todo_mcp.git
   cd todo_mcp
   

2. 仮想環境を作成して有効化します：

   python -m venv .venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

3. 必要なパッケージをインストールします：

   pip install fastmcp aiofiles
   

Running the Server

次のコマンドでサーバーを実行します：

python todolist_server.py

サーバーが起動し、Claude Desktop から接続できるようになります。

Environment Variables

次の環境変数を使用してサーバーを設定できます：

• TODO_FILE：Todo の保存先となる JSON ファイルのパス（デフォルト：スクリプトと同じディレクトリにある todos.json）
• TODO_BACKUP_DIR：バックアップの保存先ディレクトリのパス（デフォルト：スクリプトと同じディレクトリにある backups）

Available Tools

サーバーでは次のツールを使用できます：

add_todo

新しい Todo アイテムを追加します。

Parameters:

• title：Todo のタイトル（必須、最大 100 文字）
• description：詳細な説明（任意、最大 1000 文字）
• due_date：YYYY-MM-DD 形式の期限（任意）
• status：Todo のステータス（任意、次のいずれか：pending、in_progress、done、cancelled）
• priority：優先度（任意、次のいずれか：low、medium、high、critical）
• tags：分類用のタグのリスト（任意）

list_todos

フィルタリング、並べ替え、ページネーションを指定して Todo を一覧表示します。

Parameters:

• status：ステータスでフィルタリング（任意、次のいずれか：pending、in_progress、done、cancelled）
• priority：優先度でフィルタリング（任意、次のいずれか：low、medium、high、critical）
• search：タイトルと説明を検索（任意）
• tag：タグでフィルタリング（任意）
• due_date_filter：期限でフィルタリング（任意、次のいずれか：overdue、today、upcoming、no_date）
• sort_by：並べ替えに使用するフィールド（任意、デフォルト：id）
• sort_order：並べ替え順（任意、次のいずれか：asc、desc、デフォルト：asc）
• limit：返す Todo の最大数（任意、デフォルト：100）
• offset：スキップする Todo の数（任意、デフォルト：0）

get_todo

ID で Todo を取得します。

Parameters:

• todo_id：取得する Todo の ID

update_todo

ID で Todo を更新します。

Parameters:

• todo_id：更新する Todo の ID
• title：新しいタイトル（任意）
• description：新しい説明（任意）
• due_date：YYYY-MM-DD 形式の新しい期限（任意）
• status：新しいステータス（任意、次のいずれか：pending、in_progress、done、cancelled）
• priority：新しい優先度（任意、次のいずれか：low、medium、high、critical）
• tags：新しいタグのリスト（任意）

complete_todo

ID で Todo を完了としてマークします。

Parameters:

• todo_id：完了としてマークする Todo の ID

delete_todo

ID で Todo を削除します。

Parameters:

• todo_id：削除する Todo の ID

batch_delete_todos

複数の Todo を ID で削除します。

Parameters:

• todo_ids：削除する Todo ID のリスト

create_backup

Todo ファイルの手動バックアップを作成します。

Parameters: なし

get_statistics

Todo に関する統計情報を取得します。

Parameters: なし

Data Structure

Todo は次の構造で保存されます：

{
  "id": 1,
  "title": "Complete project report",
  "description": "Finish the quarterly project report",
  "due_date": "2025-05-20",
  "status": "pending",
  "priority": "high",
  "tags": ["work", "quarterly"],
  "created_at": "2025-05-09T12:00:00.000000",
  "updated_at": "2025-05-09T12:00:00.000000"
}

License

MIT