agent-task-planner
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agent-task-plannerBreak down building a weather dashboard into a task plan with dependencies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agent-task-planner
数字管道 · AI Agent 工具链 #1 —— 把高层目标拆成可执行的任务计划 DAG(Agent 的「规划大脑」积木)
agent-task-planner 是一个轻量、模型无关的任务规划器:给它一个高层目标,它输出一个带依赖关系、带验收标准、带质量门控的结构化任务计划。可作为本地 CLI 使用,也可作为 MCP 工具被任意 Agent 调用。
定位
Agent 工具链的第一块积木:规划。在「想做一件事」和「开始做」之间,先有一份可验证的计划。它不替你执行,只负责把目标结构化,并守住质量门控(依赖无环、验收齐全、含验证步)。
Related MCP server: taskguard-mcp
数字管道契约
输入 goal (高层目标) + constraints (可选约束)
│
▼
处理 拆解引擎:LLM 语义拆解(默认 Ollama 本地模型)│ 启发式规则拆解(离线兜底)
│
▼
输出 Plan = 任务列表[
id, title, type(research|design|code|write|verify),
depends_on[], acceptance[], effort(S|M|L)
] + 质量门控(validate)双引擎
引擎 | 触发条件 | 特点 |
LLM 语义拆解 | 设置 | 贴合目标的语义级拆解,走任意 OpenAI 兼容接口 |
启发式拆解 | 未配置 LLM | 基于关键词的规则拆解,离线即可用,保证工具永远能跑 |
LLM 调用失败时自动回退启发式,不会让工具「罢工」。
安装
cd agent-task-planner
pip install -r requirements.txt
# 可选:启用 LLM 引擎
pip install openai用法
1. CLI
# 拆解为 markdown 计划(默认)
python cli.py plan "为一个 Python 库实现 MCP 接入并发布到 GitHub"
# 导出 mermaid(可直接贴进支持 mermaid 的 Markdown 渲染器)
python cli.py plan "写一个爬虫抓取天气数据" -f mermaid
# 导出 json 并落盘,再校验
python cli.py plan "搭建个人博客" -f json > plan.json
python cli.py validate plan.json
python cli.py export plan.json -f markdown2. MCP 工具(推荐给 Agent)
启动后向 MCP 客户端暴露 3 个工具:
工具 | 说明 |
| 拆解目标为任务计划 DAG(JSON) |
| 校验计划:依赖完整性、是否存在环、验收标准、质量门控 |
| 导出 markdown / json / mermaid |
接入 WorkBuddy:把 examples/workbuddy_mcp.json 的内容合并进
~/.workbuddy/mcp.json,并在连接器面板「信任」该服务。
3. 作为库调用
from planner import plan
p = plan("为项目补充单元测试")
print(p.to_markdown())
v = p.validate() # {"ok": True, "issues": [], "task_count": 4}配置 LLM(可选)
设置环境变量即可切换为 LLM 语义拆解(任意 OpenAI 兼容接口):
export ATP_LLM_BASE_URL="http://localhost:11434/v1" # Ollama 本地
export ATP_LLM_API_KEY="ollama"
export ATP_LLM_MODEL="qwen2.5:7b"自检
python examples/check_planner.py验证 拆解 → 导出(markdown/mermaid) → 校验 → 环检测 全链路可用。
项目家族
属于「数字管道」开源家族的 AI Agent 工具链 分支:
agent-task-planner(本仓库)—— 规划大脑(规划中)mcp-tool-router —— 工具路由网关
(规划中)agent-skill-forge —— 技能脚手架生成器
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Durable, user-controlled goals and governed plans for AI agents.
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
Create, read and live-edit visual boards, Kanban plans, Gantt timelines and diagrams with AI agents.
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables local task planning and execution with DAG-based plans, multiple reasoning methods, and persistence for AI agents.-
- AlicenseAqualityCmaintenanceProvides AI agents with a lightweight task-management and self-verification layer to define goals, track checkpoints, detect scope drift, and verify completion against explicit done criteria.12MIT
- AlicenseNot gradedqualityBmaintenanceHelps AI agents decompose goals into costed execution plans, checkpoint progress with deviation tracking, and learn from past project data.31 npmMIT
- FlicenseBqualityBmaintenanceEnables AI coding assistants to run a machine-verified DESIGN→PLAN→EXECUTE→VERIFY→COMPLETE workflow with human approval gates, state integrity checks, and DAG task scheduling.7-