🚀 任务战士 MCP 服务器

本项目是基于 Node.js 实现的 Model Context Protocol (MCP) 服务器，专为 TaskWarrior 操作而设计，能帮助用户高效管理任务。

🚀 快速开始

要使用此服务器，需先确保系统上已安装并配置好 TaskWarrior (task)，然后执行以下安装命令：

npm install -g mcp-server-taskwarrior

将以下内容添加到您的 claude_desktop_config.json 文件中：

{
  "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

# 添加给姐姐打电话的高优先级任务
task add priority:H Call my sister

# 标记任务 ID 为 1 的任务为已完成
task done 1

📚 详细文档

🔧 API文档

工具

• 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 文件。