Awwaiid MCP Server Taskwarrior

🚀 任務戰士 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 文件。