任务管理器MCP服务器
此MCP服务器允许代理通过探索来编排任务工作流。它为处理复杂多步骤问题的代理提供了结构化的任务管理功能：
- 创建和组织任务 在具有依赖关系的层次结构中
- 分解复杂任务 按顺序划分为更小、更易于管理的子任务
- 跟踪任务进度 通过定义的状态（todo、进行中、完成、失败）
- 编排工作流程 具有适当的依赖性验证和关键路径跟踪
这些工具已经在GitHub Copilot in VS Code和Claude Sonnet 4上进行了广泛而成功的测试。（不幸的是，GPT-4.1和GPT-5似乎效果不佳。）
注意：使用此MCP服务器时，您应该禁用VS Code中的待办事项列表工具。
工具
create_task
- 创建必须执行的新任务。如果需要分解一个复杂的任务，在执行之前必须先使用“decomplet_task”。所有任务都以todo状态开始。在执行此任务之前以及执行此任务完成时，必须使用“update_task”。 - 输入： - title （string）：此任务的简明标题。必须脱离上下文理解 - description （string）：此任务的详细描述。必须脱离上下文理解 - goal （string）：此任务的总体目标。必须脱离上下文理解 - definitionsOfDone （字符串数组）：此任务要被视为“完成”，必须满足的详细标准列表。必须脱离上下文理解 - criticalPath （boolean）：此任务是否位于关键路径上并需要完成 - estimatedComplexity （目标）：对该任务复杂性的估计，包括： - level （枚举）：“微不足道”、“低，可能从执行前的分解中受益”、“平均，执行前必须分解”、“中等，执行前一定要分解”、 - description （string）：描述此任务的复杂性 - uncertaintyAreas （对象数组）：此任务的要求或执行存在不确定性的区域的详细列表，每个区域包含： - title （string）：这个不确定性领域的简明标题 - description （string）：此不确定性区域的描述 - 行为： - 所有任务都以todo状态开始 - 在执行此任务之前以及执行此任务完成后，必须使用“update_task” - 如果需要分解一个复杂的任务，在执行之前必须先使用“decomplet_task” - 返回：确认，包括创建的任务
decompose_task
- 将现有的复杂任务分解为更小、更易于管理的子任务。所有复杂度高于低的任务在执行前都必须分解。具有相同序列顺序的子任务可以并行执行。子任务应包括验证子任务。 - 输入： - taskID （string）：要分解的任务 - decompositionReason （string）：分解此任务的原因 - subtasks （对象数组）：要创建的较小、可管理的子任务数组，每个子任务包含： - title （string）：此子任务的简明标题。必须脱离上下文理解 - description （string）：此子任务的详细描述。必须脱离上下文理解 - goal （string）：此子任务的总体目标。必须脱离上下文理解 - definitionsOfDone （字符串数组）：此子任务必须满足的条件的详细列表，才能被视为“完成”。必须脱离上下文理解 - criticalPath （boolean）：此子任务是否位于关键路径上，并且是完成此任务所必需的 - uncertaintyAreas （对象数组）：此子任务的要求或执行存在不确定性的区域，每个区域包含： - title （string）：这个不确定性领域的简明标题 - description （string）：此不确定性区域的描述 - sequenceOrder （number）：此子任务的顺序。具有相同顺序的子任务可以并行执行 - 行为： - 所有复杂度高于低的任务在执行前都必须分解 - 具有相同序列顺序的子任务可以并行执行 - 根据序列顺序创建依赖链（后面的序列依赖于前面的序列） - 子任务应包括验证子任务 - 返回：确认，包括创建的子任务和更新的父任务
update_task
- 更新任务的状态和/或其他属性 - 输入： - tasks （对象数组）：要更新的任务，每个任务包含： - taskID （string）：要更改状态的任务的标识符 - set （object，可选）：此任务上要更新的可选属性，包括： - status （枚举，可选）：新状态（“todo”、“进行中”、“完成”或“失败”） - title （string，可选）：此任务的简明标题。必须脱离上下文理解 - description （string，可选）：此任务的详细描述。必须脱离上下文理解 - goal （string，可选）：此任务的总体目标。必须脱离上下文理解 - criticalPath （布尔值，可选）：此任务是否在关键路径上并需要完成 - estimatedComplexity （object，可选）：估计此任务的复杂性 - add （object，可选）：要添加到此任务的可选属性，包括： - dependsOnTaskIDs （字符串数组，可选）：此任务所依赖的新任务 - definitionsOfDone （字符串数组，可选）：此任务必须满足的其他条件才能被视为“完成” - uncertaintyAreas （对象数组，可选）：此任务的要求或执行存在不确定性的其他区域 - lessonsLearned （字符串数组，可选）：执行此任务时吸取的经验教训，可能为未来的任务提供信息 - verificationEvidence （字符串数组，可选）：验证此任务是否按计划执行，以及是否符合完成定义的证据 - remove （object，可选）：要从此任务中删除的可选属性，包括： - dependsOnTaskIDs （字符串数组，可选）：此任务不再依赖的任务 - 行为： - 在执行任务之前以及执行任务完成后必须使用此工具 - 如果依赖关系允许，可用于一次设置多个任务的状态 - 如果可能的话，应始终包括经验教训，以指导未来的任务 - 只有在所有关键路径依赖关系都已完成的情况下，任务才能转换为“完成” - 在允许更改之前验证状态转换和依赖关系 - 无法从“完成”转换为“失败”，反之亦然 - 返回：状态转换确认，包括更新的任务
task_info
- 返回所请求任务的完整详细信息 - 输入： - taskIDs （字符串数组）：用于检索信息的任务ID列表 - 行为： - 返回完整的任务详细信息，包括所有属性（状态、依赖关系、描述等） - 通过在单独的列表中返回缺失的任务ID，优雅地处理它们 - 返回：对象包含已找到的任务数组和任何未找到的任务ID
current_task*（仅限单代理模式）*
- 返回当前正在进行的任务列表。 - 输入：无 - 行为： - 仅在启用单代理模式时可用(SINGLE_AGENT=true) - 筛选任务以仅返回当前正在进行的任务 - 有助于代理在压缩对话历史记录后恢复任务上下文 - 返回：包含当前任务数组的对象
单代理模式
任务管理器支持一种特殊的“单代理模式”，可以通过设置环境变量来启用 SINGLE_AGENT=true在这种模式下，服务器将提供额外的 current_task 工具。
这对于长时间运行的代理非常有用，其中代理循环正在压缩/总结代理的对话历史，以防止超过上下文窗口限制。在这些情况下，代理可能会“忘记”存在哪些任务，因为任务ID已从上下文窗口中删除。单代理模式允许代理使用 current_task 工具，使其能够恢复有关当前任务树的信息。
如果您计划同时使用此MCP服务器和多个代理，请不要启用单代理模式。如果启用，则一次只能有一个代理使用MCP服务器。
启用单代理模式
在启动服务器之前设置环境变量：
SINGLE_AGENT=true npx @blizzy/mcp-task-manager或者在Claude Desktop配置中：
{
"mcpServers": {
"task-manager": {
"command": "npx",
"args": ["-y", "@blizzy/mcp-task-manager"],
"env": {
"SINGLE_AGENT": "true"
}
}
}
}推荐代理提示片段
说明部分
# Agent Instructions
For any user request, DO THIS FIRST: Use the Task Management tools to create a new task for the user's request. Always add these uncertainty areas as the first ones to the task:
1. Project overview as documented in README.md and CLAUDE.md
2. Project configuration, such as test commands
Resolve the user's request completely by executing all incomplete tasks. Doing so may include:
- Gathering information or doing research
- Writing or editing code or other content
- Fixing problems
- etc.
Use all tools available to you to help you in executing tasks, as appropriate. This includes:
- Use the Task Management Tools to manage your tasks. Always use these tools to manage your tasks.
- Use the Reasoning Tools to gather information and do research, work structured and logically, and stay on track. It is very important to use these tools often to execute tasks effectively.
- Use the Web Access Tools to gather information and do research. Use these tools as needed.
Always follow the Agent Rules, especially when writing or editing code or other content.
Keep executing tasks until all tasks are complete. The user's request is considered resolved once all tasks are complete.任务管理工具部分
# Task Management Tools
You must use the following tools to manage and organize your tasks. This is essential for effective task tracking, prioritization, and ensuring that all steps are completed in the correct order. Using these tools will help you maintain clear oversight of your work and dependencies throughout the process.
'create_task' allows you to create a new task that needs to be executed. If decomposing a complex task is required, you must use 'decompose_task' to break it down into smaller, more manageable subtasks.
Pay attention that tasks can depend on each other. You may need to execute them in a specific order. Always check the dependencies of a task before executing it, and complete the dependencies first.使用Claude Desktop（使用 stdio运输)
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"task-manager": {
"command": "npx",
"args": [
"-y",
"@blizzy/mcp-task-manager"
]
}
}
}使用VS代码
为了快速安装，请使用下面的一键安装按钮。
](https://insiders.vscode.dev/redirect/mcp/install?name=task-manager&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Ftask-manager%22%5D%7D&quality=insiders)
对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).
您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。
请注意mcp中不需要密钥.vscode/mcp.json文件。
NPX
{
"mcp": {
"servers": {
"task-manager": {
"command": "npx",
"args": ["-y", "@blizzy/mcp-task-manager"]
}
}
}
}从源代码运行 HTTP+SSE传输 （已弃用 2025-03-26)
pnpm install
pnpm run start:sse从源代码运行 可流式HTTP传输
pnpm install
pnpm run start:streamableHttp作为已安装的软件包运行
安装
npm install -g @blizzy/mcp-task-manager@latest运行默认（stdio）服务器
npx @blizzy/mcp-task-manager或者明确指定stdio
npx @blizzy/mcp-task-manager stdio运行SSE服务器
npx @blizzy/mcp-task-manager sse运行可流式传输的HTTP服务器
npx @blizzy/mcp-task-manager streamableHttp许可证
此软件包根据MIT许可证获得许可。