DeltaTask MCP

DeltaTask-高级任务管理系统

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

特性

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

技术细节

数据模型

• 任务：具有属性的核心任务实体：

- 标题和说明 - 紧急程度（1-5分，5分为最高） - 努力（1-21级，遵循斐波那契数列） - 完成状态 - 子任务的父子关系 - 分类标签

数据库模式

该应用程序使用SQLite和下表：

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

黑曜石融合

DeltaTask创建并维护一个结构化的黑曜石拱顶：

• 带有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
• 黑曜石（可选，用于降价集成）

安装

1. 克隆此存储库

1. 使用以下命令设置Python环境 uv:

   # 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文件.

例如，从文档中：

您可能需要将完整路径放在 uv 可执行于 command 现场。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

1. 单击锤子图标，使用Claude for Desktop中的DeltaTask工具

模型上下文协议（MCP）

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

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

许可证

MIT许可证