DeltaTask - 高级任务管理系统

一个强大的、本地托管的任务管理应用程序，具有 Obsidian 集成和模型上下文协议 (MCP) 服务器。

功能

• 智能任务管理：创建具有紧急程度和工作量估计的任务
• 优先级引擎：根据紧急程度和工作量自动对任务进行排序
• 任务分解：将较大的任务分解为可管理的子任务
• 标签系统：使用自定义标签组织任务
• 本地存储：所有数据都本地存储在 SQLite 数据库中
• Obsidian 集成：与 Obsidian markdown 文件双向同步
• MCP 服务器：通过模型上下文协议完全 API 访问

技术细节

数据模型

• 任务：核心任务实体，具有以下属性：
  • 标题和描述
  • 紧急程度（1-5 级，5 为最高）
  • 工作量（1-21 级，遵循斐波那契数列）
  • 完成状态
  • 子任务的父子关系
  • 用于分类的标签

数据库模式

该应用程序使用 SQLite，包含以下表：

• todos：存储所有任务项及其属性
• tags：存储唯一的标签名称
• todo_tags：任务和标签之间多对多关系的连接表

Obsidian 集成

DeltaTask 创建并维护一个结构化的 Obsidian vault：

• 带有 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 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 工具

模型上下文协议 (MCP)

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

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

许可证

MIT 许可证