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 仓库：

• 带有 frontmatter 元数据的任务文件
• 基于标签的视图，用于筛选任务
• 统计信息仪表板
• 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 许可证