使用说明

项目简介

DeltaTask 是一个强大的本地任务管理系统，它不仅提供智能的任务创建、优先级排序、任务分解和标签管理等功能，还通过内置的 Model Context Protocol (MCP) 服务器，使得大型语言模型 (LLM) 能够安全地访问和操作您的任务数据。通过与 Obsidian 的双向同步，您可以利用 Markdown 文件来可视化和编辑任务，构建个性化的任务管理工作流。

主要功能点

智能任务管理：创建包含优先级和工作量评估的任务。
优先级引擎：根据优先级和工作量自动排序任务。
任务分解：将大型任务拆分为可管理的子任务。
标签系统：使用自定义标签组织任务。
本地存储：所有数据本地存储在 SQLite 数据库中。
Obsidian 集成：与 Obsidian Markdown 文件双向同步，方便可视化和编辑。
MCP 服务器：通过 Model Context Protocol 提供完整的 API 访问，允许 LLM 客户端（如 Claude for Desktop）调用工具管理任务。

安装步骤

克隆仓库

git clone https://github.com/brysontang/DeltaTask
cd DeltaTask

设置 Python 环境 确保您已安装 Python 3.10+ 和 SQLite3。推荐使用 'uv' 管理 Python 环境和依赖。

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 或 .venv\Scripts\activate (Windows)

# 安装依赖
uv pip install -r requirements.txt

服务器配置

要将 DeltaTask MCP 服务器与 MCP 客户端（例如 Claude for Desktop）连接，您需要配置客户端的服务器设置。以 Claude for Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件（通常位于 '~/Library/Application Support/Claude/'）：

{
  "mcpServers": {
    "deltatask": {  // 服务器名称，您可以自定义
      "command": "uv",  // 启动命令，这里使用 uv
      "args": [
        "--directory",  // 指定工作目录
        "/ABSOLUTE/PATH/TO/DeltaTask",  // 替换为 DeltaTask 仓库的绝对路径
        "run",  // 运行 Python 脚本
        "server.py"  // 服务器脚本文件名
      ]
    }
  }
}

请务必将 '/ABSOLUTE/PATH/TO/DeltaTask' 替换为您本地 DeltaTask 仓库的绝对路径。 您可以使用 'pwd' 命令 (macOS/Linux) 或 'Get-Location' 命令 (PowerShell on Windows) 获取当前目录的绝对路径。

配置完成后，重启 Claude for Desktop 使配置生效。

基本使用方法

成功配置 MCP 服务器后，在 Claude for Desktop 中，您可以通过点击工具图标（通常是一个锤子图标）来访问 DeltaTask 提供的任务管理工具。您可以指示 Claude 使用这些工具来创建、查询、更新或删除任务，例如：

"使用 DeltaTask 创建一个名为 '撰写项目报告' 的任务，优先级设为高，截止日期为下周五。"
"使用 DeltaTask 搜索包含 '会议' 标签的任务。"
"使用 DeltaTask 完成 ID 为 'task-123' 的任务。"

请参考仓库的 'README.md' 和 'server.py' 文件，了解所有可用的 MCP 工具及其参数。

关键词