mcp-server-taskwarrior

🚀 任务战士 MCP 服务器

这是一个使用 Node.js 实现的 TaskWarrior 操作的模型上下文协议 (MCP) 服务器，能帮助你高效管理任务。

🚀 快速开始

要使用此服务器，你需要先安装并配置好 TaskWarrior (task)，然后执行以下命令进行安装：

npm install -g mcp-server-taskwarrior

将以下内容添加到你的 claude_desktop_config.json 中，以便与 Claude Desktop 结合使用：

{
  "mcpServers": {
    "taskwarrior": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-taskwarrior"
      ]
    }
  }
}

✨ 主要特性

• 查看待处理任务
• 根据项目和标签过滤任务
• 添加新任务，包括描述、截止日期、优先级、项目和标签
• 将任务标记为完成

⚠️ 重要提示

此处运行的是本地 task 二进制文件，因此需要安装并配置好 TaskWarrior！

⚠️ 重要提示

当前版本使用的是任务的 id，这是一个不稳定的标识符；当新增或删除任务时，TaskWarrior 有时会重新编号。未来将更加谨慎地处理此问题，改用任务 UUID。

📦 安装指南

npm install -g mcp-server-taskwarrior

确保你已经安装并配置好了 TaskWarrior (task)。

💻 使用示例

基础用法

以下是一些示例使用场景：

• 我有哪些当前的工作任务?
  • 执行: task project:work next
• TODO: 呼叫我的姐妹（高优先级）
  • 执行: task add priority:H Call my sister
• 好的，我已经呼叫了我的姐妹
  • 执行: task done 1

📚 详细文档

工具

• get_next_tasks

  • 获取所有待处理任务的列表
  • 可选过滤条件:
    • project: 根据项目名称筛选
    • tags: 根据一个或多个标签筛选

• add_task

  • 添加一个新的任务到 TaskWarrior
  • 必填项:
    • description: 任务描述文本
  • 可选项:
    • due: 截止日期 (ISO 时间戳)
    • priority: 优先级水平 ("H", "M" 或 "L")
    • project: 项目名称 (小写带点)
    • tags: 标签数组 (小写)

• mark_task_done

  • 将任务标记为完成
  • 必填项:
    • identifier: 任务 ID 或 UUID

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。详细信息请参阅 LICENSE 文件。