MCP 任务管理器

简介

MCP 任务管理器是一款用于管理和执行 AI 任务的服务器端工具。它支持多步骤任务规划、进度跟踪以及用户审批等功能，帮助您更高效地完成复杂的项目。

功能概述

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. 扩展支持
   支持自定义规则和工具推荐，帮助任务执行更加高效。

安装与使用

1. 安装
   使用 Node.js 包管理器进行全局安装：

   npm install -g taskqueue-mcp
   

2. 运行 CLI 工具
   通过 npx 运行命令行工具并查看帮助信息：

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

核心命令

1. 批准任务
   使用以下命令批准特定项目中的任务：

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

   • 选项：--force 可以强制批准未完成的任务。

2. 列出任务和项目
   查看所有项目或指定项目的详细信息：

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

3. 初始化新项目
   创建并初始化一个新的项目：

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