DeltaTask - Advanced Task Management System

DeltaTask - 高度なタスク管理システム

Obsidian 連携と Model Context Protocol（MCP）サーバーを備えた、強力なローカルホスト型タスク管理アプリケーションです。

機能

• スマートなタスク管理：緊急度レベルと作業量の見積もりを設定してタスクを作成できます
• 優先順位付けエンジン：緊急度と作業量に基づいてタスクを自動的に並べ替えます
• タスクの分解：大きなタスクを管理しやすいサブタスクに分割できます
• タグシステム：カスタムタグでタスクを整理できます
• ローカルストレージ：すべてのデータは SQLite データベースにローカル保存されます
• Obsidian 連携：Obsidian の Markdown ファイルと双方向で同期します
• MCP サーバー：Model Context Protocol を通じて API にフルアクセスできます

技術詳細

データモデル

• タスク：以下のプロパティを持つ基本的なタスクエンティティです。
  • タイトルと説明
  • 緊急度（1～5 の段階で、5 が最も高い）
  • 作業量（フィボナッチ数列に従った 1～21 の段階）
  • 完了ステータス
  • サブタスクの親子関係
  • 分類用のタグ

データベーススキーマ

このアプリケーションでは SQLite を使用しており、以下のテーブルがあります。

• todos：すべてのタスク項目とそのプロパティを保存します
• tags：一意のタグ名を保存します
• todo_tags：タスクとタグの多対多関係を管理する中間テーブルです

Obsidian 連携

DeltaTask は、構造化された Obsidian Vault を作成し、維持します。

• フロントマターのメタデータを含むタスクファイル
• タスクを絞り込むためのタグベースのビュー
• 統計ダッシュボード
• Obsidian の Markdown と SQLite データベース間の双方向同期

MCP API エンドポイント

MCP サーバーでは以下の操作を利用できます。

• get_task_by_id：ID を指定して特定のタスクを取得します
• search_tasks：タイトル、説明、またはタグでタスクを検索します
• create_task：新しいタスクを作成します
• update_task：タスクのプロパティを更新します
• delete_task：タスクを削除します
• sync_tasks：Obsidian の Markdown から SQLite にタスクを同期します
• list_tasks：すべてのタスクを一覧表示します
• get_statistics：タスクに関する指標を取得します
• create_subtasks：タスクを複数のサブタスクに分割します
• get_all_tags：一意のタグ名をすべて取得します
• get_subtasks：指定した親タスクのサブタスクを取得します
• finish_task：タスクを完了としてマークします

はじめに

前提条件

• Python 3.10+
• SQLite3
• Obsidian（任意。Markdown 連携に使用）

インストール

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

2. uv を使用して Python 環境をセットアップします。

   # Create and activate the virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv pip install -r requirements.txt
   

MCP サーバーの実行

DeltaTask MCP サーバーは、Claude for Desktop と併用できます。

1. Claude for Desktop を設定します。

   • ~/Library/Application Support/Claude/claude_desktop_config.json を開くか、新規作成します
   • DeltaTask サーバーの設定を追加します。

   {
     "mcpServers": {
       "deltatask": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/DeltaTask",
           "run",
           "server.py"
         ]
       }
     }
   }
   

   • Claude for Desktop を再起動します

問題が発生した場合や詳しい情報が必要な場合は、MCP のドキュメントをご覧ください。

ドキュメントからの例：

command フィールドに uv 実行ファイルのフルパスを指定する必要がある場合があります。MacOS/Linux では which uv、Windows では where uv を実行すると確認できます。

2. ハンマーアイコンをクリックして、Claude for Desktop で DeltaTask のツールを使用します

Model Context Protocol（MCP）

このアプリケーションは、タスク管理に Model Context Protocol のアプローチを採用しています。

1. 構造化データモデル：関係性を含むタスクのスキーマを明確に定義します
2. 優先度の計算：複数の要素に基づいてタスクをインテリジェントに並べ替えます
3. 階層的な整理：タスクの分解に親子関係を使用します
4. タグシステム：状況を把握しやすくする柔軟な分類機能です
5. 統計と分析：タスクのパターンを把握するためにデータを集計します
6. Obsidian 連携：Markdown による可視化と編集が可能です

ライセンス

MIT License