Taskqueue

🚀 MCP 任務管理器

MCP 任務管理器是一款強大的服務器端工具，專為管理和執行 AI 任務而設計。它具備多步驟任務規劃、進度跟蹤和用戶審批等功能，能助力您高效完成複雜項目，提升工作效率。

🚀 快速開始

MCP 任務管理器可幫助您高效管理和執行 AI 任務。您可以通過 Node.js 包管理器進行全局安裝，然後使用命令行工具開展任務管理工作。

✨ 主要特性

1. 任務規劃：支持多步驟任務規劃，每個任務涵蓋標題、詳細描述、狀態（未開始、進行中、已完成）、批准狀態等信息。
2. 進度跟蹤：提供詳細的進度指標，包含完成的任務數和總任務數。
3. 用戶審批：用戶可通過命令行工具直接批准任務，確保每個任務在完成前經過人工審核。
4. 數據存儲：數據保存為 JSON 文件，默認路徑因操作系統而異：
   • Linux：~/.local/share/taskqueue-mcp/tasks.json
   • macOS：~/Library/Application Support/taskqueue-mcp/tasks.json
   • Windows：%APPDATA%\taskqueue-mcp\tasks.json
5. 擴展支持：支持自定義規則和工具推薦，讓任務執行更高效。

📦 安裝指南

安裝

使用 Node.js 包管理器進行全局安裝：

npm install -g taskqueue-mcp

運行 CLI 工具

通過 npx 運行命令行工具並查看幫助信息：

npx --package=taskqueue-mcp taskqueue --help

💻 使用示例

基礎用法

批准任務

使用以下命令批准特定項目中的任務：

npx taskqueue approve-task -- <projectId> <taskId>

選項：--force 可以強制批准未完成的任務。

列出任務和項目

查看所有項目或指定項目的詳細信息：

npx taskqueue list-tasks [--project=<projectId>]

初始化新項目

創建並初始化一個新的項目：

npx taskqueue create-project -- <projectId> <initialPrompt>

📚 詳細文檔

數據結構

任務管理器的數據文件遵循以下 JSON 格式：

{
  "projects": [
    {
      "projectId": "proj-123", // 項目唯一標識符
      "initialPrompt": "分析用戶行為數據並生成報告", // 初始用戶請求文本
      "projectPlan": "詳細計劃和步驟說明", // 項目計劃描述
      "completed": false, // 項目完成狀態
      "tasks": [
        {
          "id": "task-456", // 任務唯一標識符
          "title": "收集數據", // 任務標題
          "description": "從數據庫中提取過去三個月的用戶行為數據", // 任務描述
          "status": "not started", // 任務狀態：未開始、進行中或已完成
          "approved": false, // 任務審批狀態
          "completedDetails": "數據收集完成，已存儲在分析表中", // 完成詳細信息（當狀態為“已完成”時必填）
          "toolRecommendations": "使用 Tableau 進行數據分析", // 工具推薦
          "ruleRecommendations": "遵循數據隱私保護政策" // 規則推薦
        }
      ]
    }
  ]
}

環境變量配置

如果需要自定義數據文件的存儲路徑，可以通過設置 TASK_MANAGER_FILE_PATH 環境變量實現：

export TASK_MANAGER_FILE_PATH="/path/to/tasks.json"

然後在 MCP 客戶端配置中添加相同的環境變量。

📄 許可證

MCP 任務管理器採用 MIT 許可證，具體條款請參考項目倉庫中的 LICENSE 文件。