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 环境：

   # 创建并激活虚拟环境
   uv venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   
   # 安装依赖
   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 来获取该路径。

1. 通过点击锤子图标使用 Claude 桌面版中的 DeltaTask 工具

模型上下文协议 (MCP)

此应用程序实现了一种用于任务管理的模型上下文协议方法：

1. 结构化数据模型：具有关系的任务定义明确的模式
2. 优先级计算：基于多个因素的智能排序
3. 层次组织：任务分解的父子关系
4. 标签系统：更灵活的分类以提供更好的上下文
5. 统计和洞察：数据聚合以了解任务模式
6. Obsidian 集成：基于 Markdown 的可视化和编辑

许可证

MIT 许可证