DeltaTask MCP Server

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

Obsidian 統合と Model Context Protocol (MCP) サーバーを備えた、ローカルでホストされる強力なタスク管理アプリケーションです。

特徴

• スマートタスク管理：緊急度と労力見積もりでタスクを作成
• 優先順位付けエンジン: タスクを緊急度と労力で自動的に分類します
• タスク分解: 大きなタスクを管理しやすいサブタスクに分割する
• タグ付けシステム: カスタムタグでタスクを整理
• ローカルストレージ: すべてのデータはSQLiteデータベースにローカルに保存されます
• Obsidian 統合: Obsidian マークダウンファイルとの双方向同期
• MCP サーバー: モデル コンテキスト プロトコルによる完全な API アクセス

技術的な詳細

データモデル

• タスク: プロパティを持つコア タスク エンティティ:
  • タイトルと説明
  • 緊急度（1～5段階、5が最高）
  • 努力（1～21スケール、フィボナッチ数列に従う）
  • 完了ステータス
  • サブタスクの親子関係
  • 分類用のタグ

データベーススキーマ

アプリケーションは、次のテーブルで SQLite を使用します。

• todos : すべてのタスク項目とそのプロパティを保存します
• tags : 一意のタグ名を保存します
• todo_tags : タスクとタグ間の多対多関係のジャンクションテーブル

Obsidianの統合

DeltaTask は構造化された Obsidian ボールトを作成し、維持します。

• フロントマターメタデータを含むタスクファイル
• タスクをフィルタリングするためのタグベースのビュー
• 統計ダッシュボード
• 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（オプション、マークダウン統合用）

インストール

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 をデスクトップ用に設定する:
   • ~/Library/Application Support/Claude/claude_desktop_config.jsonを開くか作成します。
   • DeltaTask サーバー構成を追加します。
   { "mcpServers": { "deltatask": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/DeltaTask", "run", "server.py" ] } } }
   • デスクトップ版のClaudeを再起動

問題が発生した場合や詳細を知りたい場合は、 MCP のドキュメントを参照してください。

たとえば、ドキュメントから引用します:

commandフィールドにuv実行ファイルへのフルパスを入力する必要があるかもしれません。これは、MacOS/Linuxではwhich uv 、Windowsではwhere uv実行することで取得できます。

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

モデルコンテキストプロトコル（MCP）

このアプリケーションは、タスク管理のためのモデル コンテキスト プロトコル アプローチを実装します。

1. 構造化データモデル: 関係のあるタスクの明確に定義されたスキーマ
2. 優先度計算：複数の要素に基づいたインテリジェントなソート
3. 階層的組織：タスク分解のための親子関係
4. タグ付けシステム: コンテキストを良くするための柔軟な分類
5. 統計と洞察：タスクパターンを理解するためのデータ集約
6. Obsidian 統合: Markdown ベースの視覚化と編集

ライセンス

MITライセンス