awwaiid_mcp-server-taskwarrior

🚀 任务战士 MCP 服务器

基于 Node.js 实现的 Model Context Protocol (MCP) 服务器，用于 TaskWarrior 操作，可帮助用户高效管理任务。

🚀 快速开始

此服务器运行依赖本地的 task 可执行文件，因此在使用前需要安装并配置好 TaskWarrior。以下是安装此服务器的命令：

npm install -g mcp-server-taskwarrior

✨ 主要特性

• 🔍 查看待处理任务
• 📂 按项目和标签过滤任务
• ➕ 添加新任务（带描述、截止日期、优先级、项目和标签）
• ✅ 标记任务为完成状态

⚠️ 重要提示

此服务器运行您的本地 task 可执行文件，因此需要安装并配置好 TaskWarrior。

⚠️ 重要提示

当前版本使用任务 id，这是一个不稳定的标识符；TaskWarrior 在添加或删除任务时可能会重新编号。未来版本将更加谨慎，改用任务 UUID。

📦 安装指南

npm install -g mcp-server-taskwarrior

请确保您的系统上已安装并配置好 TaskWarrior (task)。

💻 使用示例

基础用法

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

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

高级用法

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

• 我当前的工作任务有哪些？
  • 执行：task project:work next
• TODO：给姐姐打电话（高优先级）
  • 执行：task add priority:H Call my sister
• 好，我已经打了电话
  • 执行：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 文件。