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