DeltaTask MCP Server

DeltaTask - 高级任务管理系统

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

特征

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

技术细节

数据模型

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

数据库架构

该应用程序使用带有下表的 SQLite：

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

Obsidian 集成

DeltaTask 创建并维护一个结构化的 Obsidian 保险库：

• 带有前置元数据的任务文件
• 基于标签的视图用于过滤任务
• 统计信息仪表板
• 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 桌面版：
   • 打开或创建~/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来获取此路径。

2. 单击锤子图标即可使用 Claude for Desktop 中的 DeltaTask 工具

模型上下文协议（MCP）

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

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

执照

MIT 许可证