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