Deltatask

🚀 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 ボールトを作成および維持します。

• フロントメタデータ付きのタスクファイル
• タグベースのビューでタスクをフィルタリング
• 統計情報ダッシュボード
• SQLite データベースと Obsidian Markdown 間の双方向同期

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 環境を設定します。

# 仮想環境を作成してアクティブ化する
uv venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

# 依存関係をインストールする
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 実行ファイルの完全なパスを入れる必要がある場合があります。which uv（MacOS/Linux）を実行するか、その場所を調べることで取得できます。

上記の手順を完了すると、Claude は DeltaTask サーバーに接続して通信できるはずです。

💻 使用例

以下は DeltaTask MCP サーバーとのやり取りを示す簡単な Python スクリプトの例です。

import requests

# すべてのタスクを取得する
response = requests.get('http://localhost:5000/list_tasks')
print(response.json())

# 新しいタスクを作成する
new_task = {
    'title': '完成项目报告',
    'description': '提交季度项目报告给管理层',
    'urgency': 3,
    'workload': 10
}
response = requests.post('http://localhost:5000/create_task', json=new_task)
print(response.json())

# 既存のタスクを更新する
updated_task = {
    'task_id': 1,
    'title': '优先完成项目报告',
    'urgency': 5
}
response = requests.put('http://localhost:5000/update_task/1', json=updated_task)
print(response.json())

📄 注意事項

⚠️ 重要提示

サーバーを実行する際には、適切なファイアウォールとセキュリティ対策を設定することを確認してください。

⚠️ 重要提示

本番環境では、HTTPS を使用し、認証を有効にすることをおすすめします。

⚠️ 重要提示

データの損失を防ぐために、定期的に SQLite データベースをバックアップしてください。

これらの手順に従えば、DeltaTask タスク管理システムを簡単に設定して使用を開始できます。