TaskFlow MCP

TaskFlow MCP🔄✅

用于与 AI 助手一起规划和执行任务的任务管理模型上下文协议 (MCP) 服务器。

🌟 概述

TaskFlow MCP 是一款专用服务器，可帮助 AI 助手将用户请求分解为可管理的任务并跟踪其完成情况。它强制执行结构化的工作流，并包含用户审批步骤，以确保任务得到正确跟踪，并保持用户对流程的控制。

✨ 特点

📋任务规划：将复杂的请求分解为可管理的任务
🔍子任务：将任务划分为更小、更易于管理的子任务
📊进度跟踪：使用可视化进度表跟踪任务、子任务和请求的状态
👍用户批准：强制用户批准步骤以确保质量和控制
💾持久性：将任务和请求保存到磁盘，以便在会话之间持久化
🔄灵活管理：根据需要添加、更新或删除任务和子任务
📝详细报告：查看任务详细信息和进度表
📤导出选项：以 Markdown、JSON 或 HTML 格式导出任务计划和状态报告
📦依赖关系：使用版本信息跟踪项目和任务级依赖关系
📌注释：为重要信息和偏好添加项目级注释

🚀 安装

全局安装

npm install -g @pinkpixel/taskflow-mcp

本地安装

npm install @pinkpixel/taskflow-mcp

🛠️ 使用方法

启动服务器

如果全局安装：

taskflow-mcp

如果本地安装：

npx taskflow-mcp

配置

默认情况下，TaskFlow MCP 将任务保存到~/Documents/tasks.json 。您可以通过设置TASK_MANAGER_FILE_PATH环境变量来更改此设置：

TASK_MANAGER_FILE_PATH=/path/to/tasks.json taskflow-mcp

MCP 配置

要将 TaskFlow MCP 与 AI 助手配合使用，您需要配置 MCP 客户端以使用服务器。创建一个包含以下内容的mcp_config.json文件：

{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/taskflow-mcp"],
      "env": {
        "TASK_MANAGER_FILE_PATH": "/path/to/tasks.json"
      }
    }
  }
}

🔄 工作流程

TaskFlow MCP 强制执行特定的工作流程：

计划任务：将用户请求分解为任务（带有可选的子任务）
获取下一个任务：检索下一个待处理的任务
完成子任务：如果任务有子任务，则在将任务标记为完成之前完成每个子任务
标记任务完成：将任务标记为已完成（需要先完成所有子任务）
等待批准：等待用户批准已完成的任务
重复：继续下一个任务，直到所有任务完成
最终批准：获得用户对整个请求的批准

为了让 AI 助手始终遵循此工作流程，请参阅example-system-prompt.md文件，了解可以添加到助手指令中的系统提示。

🧰 可用工具

TaskFlow MCP 向 AI 助手公开了以下工具：

`plan_task`

注册新的用户请求并计划其相关任务（带有可选的子任务）。

{
  "originalRequest": "Create a new website for my business",
  "outputPath": "C:/Users/username/Documents/website-project-plan.md",
  "dependencies": [
    {
      "name": "Node.js",
      "version": ">=14.0.0",
      "description": "JavaScript runtime"
    },
    {
      "name": "npm",
      "version": ">=6.0.0",
      "description": "Package manager"
    }
  ],
  "notes": [
    {
      "title": "Package Manager Preference",
      "content": "User prefers pnpm over npm for package management."
    },
    {
      "title": "Design Guidelines",
      "content": "Follow the company's brand guidelines for colors and typography."
    }
  ],
  "tasks": [
    {
      "title": "Design homepage",
      "description": "Create a design for the homepage with logo, navigation, and hero section",
      "dependencies": [
        {
          "name": "Figma",
          "description": "Design tool"
        }
      ],
      "subtasks": [
        {
          "title": "Design logo",
          "description": "Create a logo that represents the business brand"
        },
        {
          "title": "Design navigation",
          "description": "Create a user-friendly navigation menu"
        }
      ]
    },
    {
      "title": "Implement HTML/CSS",
      "description": "Convert the design to HTML and CSS",
      "dependencies": [
        {
          "name": "HTML5",
          "description": "Markup language"
        },
        {
          "name": "CSS3",
          "description": "Styling language"
        }
      ]
    }
  ]
}

`get_next_task`

检索请求的下一个待处理任务。

{
  "requestId": "req-1"
}

`mark_task_done`

将任务标记为已完成。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "completedDetails": "Created a modern design with a clean layout"
}

`approve_task_completion`

批准已完成的任务。

{
  "requestId": "req-1",
  "taskId": "task-1"
}

`approve_request_completion`

批准整个请求并认为其已完成。

{
  "requestId": "req-1"
}

`open_task_details`

获取有关特定任务的详细信息。

{
  "taskId": "task-1"
}

`list_requests`

列出系统中的所有请求。

{}

`add_tasks_to_request`

向现有请求添加更多任务。

{
  "requestId": "req-1",
  "tasks": [
    {
      "title": "Add contact form",
      "description": "Create a contact form with validation"
    }
  ]
}

`update_task`

更新任务的标题或描述。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "title": "Design responsive homepage",
  "description": "Create a responsive design for the homepage"
}

`delete_task`

从请求中删除任务。

{
  "requestId": "req-1",
  "taskId": "task-1"
}

`add_subtasks`

将子任务添加到现有任务。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtasks": [
    {
      "title": "Design logo",
      "description": "Create a logo that represents the business brand"
    },
    {
      "title": "Design navigation",
      "description": "Create a user-friendly navigation menu"
    }
  ]
}

`mark_subtask_done`

将子任务标记为已完成。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1"
}

`update_subtask`

更新子任务的标题或描述。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1",
  "title": "Design modern logo",
  "description": "Create a modern logo that represents the business brand"
}

`delete_subtask`

从任务中删除子任务。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1"
}

`export_task_status`

将请求中所有任务的当前状态导出到文件。建议使用绝对路径，以便更可靠地创建文件。

{
  "requestId": "req-1",
  "outputPath": "C:/Users/username/Documents/task-status.md",
  "format": "markdown"
}

`add_note`

为请求添加注释。

{
  "requestId": "req-1",
  "title": "Package Manager Preference",
  "content": "User prefers pnpm over npm for package management."
}

`update_note`

更新现有注释。

{
  "requestId": "req-1",
  "noteId": "note-1",
  "title": "Package Manager Preference",
  "content": "User prefers pnpm over npm and yarn for package management."
}

`delete_note`

从请求中删除注释。

{
  "requestId": "req-1",
  "noteId": "note-1"
}

`add_dependency`

向请求或任务添加依赖项。

{
  "requestId": "req-1",
  "taskId": "task-1",
  "dependency": {
    "name": "react",
    "version": "^18.2.0",
    "description": "JavaScript library for building user interfaces",
    "url": "https://reactjs.org"
  }
}

📚 文档

有关项目架构和实施的更多详细信息，请参阅OVERVIEW.md文件。

📝 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

🤝 贡献

欢迎贡献！请参阅CONTRIBUTING.md文件以获取相关指南。

📜 更新日志

请参阅CHANGELOG.md文件了解该项目的变更历史记录。

🙏 致谢

使用模型上下文协议（MCP）构建
由Pink Pixel创建

由 Pink Pixel 用❤️制作

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

任务管理服务器可帮助 AI 助手将用户请求分解为可管理的任务，并通过用户批准步骤跟踪其完成情况。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Orchestrator Server
mokafari
-
security
A
license
-
quality
A server for task orchestration and coordination, facilitating task management with dependencies, multi-instance collaboration, and persistent task tracking.
Last updated -
7
17
JavaScript
MIT License
DeltaTask MCP Server
brysontang
A
security
A
license
A
quality
Provides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.
Last updated -
12
3
Python
MIT License
Divide and Conquer MCP Server
landicefu
-
security
A
license
-
quality
Enables AI agents to break down complex tasks into manageable pieces using a structured JSON format with task tracking, context preservation, and progress monitoring capabilities.
Last updated -
12
2
JavaScript
MIT License
Tiny TODO MCP
tkc
-
security
F
license
-
quality
A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
Last updated -
1
TypeScript

View all related MCP servers

TaskFlow MCP🔄✅

🌟 概述

✨ 特点

🚀 安装

全局安装

本地安装

🛠️ 使用方法

启动服务器

配置

MCP 配置

🔄 工作流程

🧰 可用工具

plan_task

get_next_task

mark_task_done

approve_task_completion

approve_request_completion

open_task_details

list_requests

add_tasks_to_request

update_task

delete_task

add_subtasks

mark_subtask_done

update_subtask

delete_subtask

export_task_status

add_note

update_note

delete_note

add_dependency