MCP Task Manager

MCP Task Manager

site icon
2025.04.13 7
TypeScript任务管理AI 助手工具开发效率
MCP Task Manager 是一个基于 Model Context Protocol (MCP) 的 AI 任务管理服务器,旨在帮助 AI 助手以结构化的方式处理多步骤任务,并提供可选用户审批检查点。该工具支持任务规划、进度跟踪、用户审批、任务状态管理等功能,适用于需要复杂任务管理的场景。
View on GitHub

Overview

基本能力

产品定位

MCP Task Manager 是一个 AI 任务管理工具,专注于为 AI 助手提供结构化的任务管理能力,支持多步骤任务规划和用户审批流程。

核心功能

  • 任务规划与多步骤管理
  • 进度跟踪
  • 用户审批检查点(任务和项目完成审批)
  • 任务详情可视化
  • 任务状态管理
  • 增强型 CLI 用于任务检查和管

适用场景

  • AI 助手需要处理复杂多步骤任务的场景
  • 需要用户审批流程的任务管理
  • 项目管理工具集成

工具列表

项目管理工具

  • list_projects: 列出系统中的所有项目
  • read_project: 获取特定项目的详细信息
  • create_project: 创建带有初始任务的新项目
  • delete_project: 删除项目
  • add_tasks_to_project: 向现有项目添加新任务
  • finalize_project: 在所有任务完成后最终确定项目

任务管理工具

  • list_tasks: 列出特定项目的所有任务
  • read_task: 获取特定任务的详细信息
  • create_task: 在项目中创建新任务
  • update_task: 修改任务的属性(标题、描述、状态)
  • delete_task: 从项目中删除任务
  • approve_task: 审批已完成的任务
  • get_next_task: 获取项目中下一个待处理的任务
  • mark_task_done: 标记任务为已完成并添加详细信息

常见问题解答

  • 数据存储位置:默认存储在平台特定的 JSON 文件中(Linux/macOS/Windows 不同路径)
  • 自定义文件路径:通过 TASK_MANAGER_FILE_PATH 环境变量设置
  • 任务状态转换规则:系统强制执行特定的状态转换规则

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

  1. 全局安装:
npm install -g taskqueue-mcp
  1. 或使用 npx 运行:
npx --package=taskqueue-mcp taskqueue --help

调试方式

  1. 查看帮助信息:
npx taskqueue --help
  1. 列出所有任务:
npx taskqueue list-tasks
  1. 查看特定项目任务:
npx taskqueue list-tasks -- -p <projectId>
  1. 审批任务:
npx taskqueue approve-task -- <projectId> <taskId>

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。