DeltaTask MCP Server

🚀 DeltaTask - 高级任务管理系统

DeltaTask 是一款功能强大的本地托管任务管理应用程序。它不仅支持与 Obsidian 集成，还能通过 Model Context Protocol (MCP) 服务器提供完整的 API 访问，为用户提供高效的任务管理体验。

🚀 快速开始

前置条件

• Python 3.10+

✨ 主要特性

• 智能任务管理：可创建带有紧急程度和工作量估计的任务。
• 优先级引擎：能根据紧急程度和工作量自动对任务进行排序。
• 任务分解：可将较大的任务分解为可管理的子任务。
• 标签系统：支持使用自定义标签对任务进行分类。
• 本地存储：所有数据均存储在 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：标记任务为完成。