1. 模型概述:一款基于MCP的AI驱动规划助手
Software Planning Tool 本质上是一个基于 Model Context Protocol (MCP) 的服务器。你可以把它理解为一个专门负责“思考如何做软件项目”的AI模块。它不直接写代码,而是帮助你把一个模糊的、复杂的开发想法,拆解成一个清晰、可执行、带优先级和时间的任务清单。
1.1 能力评估:你的项目“拆解师”与“规划师”
这个工具就像一个经验丰富的开发队长,具备以下核心能力:
-
智能项目规划:只需告诉它一个目标(例如“开发一个用户注册与登录功能”),它就能引导你建立结构化的开发计划。
-
精细化任务管理:支持对任务进行全面的属性管理,具体能力维度如下表所示:
| 能力维度 | 具体功能 |
|---|---|
| 任务属性 | 添加、更新、移除、查询任务;支持设置标题、描述、负责人。 |
| 优先级与评估 | 设置四级优先级 (critical/high/medium/low);评估任务复杂度(0-10分)。 |
| 过程管理 | 设定任务截止日期与项目总期限;定义任务步骤与依赖关系。 |
| 分类与交付物 | 用标签对任务分类;关联代码示例、风险说明和预期产出。 |
-
进度跟踪与可视化:可更新任务状态,获取完成度统计,并生成任务依赖图和甘特图的可视化指导。
-
数据持久化:支持将整个开发计划导出为JSON文件,方便保存、分享或再次导入继续规划。
在技术接口上,它通过MCP协议暴露了 start_planning, add_todo, update_todo_status, get_todos, visualize_plan 等一系列工具(Tool)和资源(Resource),供AI客户端调用。
1.2 技术特点:轻量、集成、以AI为核心
-
基于MCP协议:这是其核心特点。MCP是一种允许AI助手(如Claude、Cursor内的AI)安全、结构化地使用外部工具和数据的协议。这意味着该工具必须与支持MCP的AI客户端搭配使用,才能发挥最大效用。
-
轻量级与模块化:工具本身是一个Node.js或Python服务(有不同实现版本),安装简单,无需重型数据库。
-
AI原生设计:它的操作逻辑是通过AI与用户对话来驱动的,非常适合在AI编码助手(如Cursor、Claude Desktop)的工作流中无缝集成,实现“边聊边规划”。
1.3 应用场景
-
个人开发者或小团队:在启动新项目或新功能时,用于快速理清思路,避免遗漏。
-
教育与学习:帮助编程新手学习如何系统性地分解一个开发项目。
-
敏捷开发:作为Backlog梳理的辅助工具,与AI结对进行用户故事拆分和任务估算。
-
组合使用:与“Sequential Thinking”(顺序思考)等其它MCP服务器组合,可实现从深度需求分析到详细任务规划的完整自动化流程,有用户反馈效率提升显著。
2. 安装与部署:在不同系统上连接AI大脑
本工具本身是一个后端服务,需要先安装,然后在你的AI客户端(如Cursor)中配置。以下是基于其Node.js主流版本的详细部署流程。
系统通用前提准备
-
安装 Node.js:确保系统已安装 Node.js (版本 14 或以上)。可从 Node.js 官网 下载。
-
安装 npm:npm 通常随 Node.js 一同安装。在终端输入
npm -v检查是否安装成功。
Windows 系统安装与配置
方式一:通过npx快速运行(推荐初学者)
这种方式无需永久安装,每次通过npx命令临时运行。
# 在命令提示符或PowerShell中直接运行
npx @zhangzhixiong/software-planning-tool
方式二:全局安装
# 1. 打开命令提示符或PowerShell,全局安装工具 npm install -g @zhangzhixiong/software-planning-tool # 2. 安装后,可通过以下命令启动服务器 software-planning-tool # 或者使用node直接运行 node %APPDATA%\npm\node_modules\@zhangzhixiong\software-planning-tool\build\index.js
方式三:配置到Claude Desktop
-
打开 Claude Desktop 应用。
-
点击顶部菜单栏
File->Settings->Developer->Edit Config。 -
在打开的配置文件中,添加以下MCP服务器配置:
{ "mcpServers": { "software-planning-tool": { "command": "cmd", "args": [ "/c", "node", "C:\\Users\\[你的用户名]\\AppData\\Roaming\\npm\\node_modules\\@zhangzhixiong\\software-planning-tool\\build\\index.js" ] } } }
请将上述路径中的 [你的用户名] 替换为你电脑的实际用户名,或者修改为你全局安装后的实际路径。
4. 保存配置文件并重启 Claude Desktop。
macOS / Linux 系统安装与配置
安装步骤
# 方式一:使用npx快速运行(推荐) npx @zhangzhixiong/software-planning-tool # 方式二:全局安装 sudo npm install -g @zhangzhixiong/software-planning-tool # 安装后,可直接运行 software-planning-tool
配置到AI客户端(以Cursor为例)
-
首先,确保工具已通过上述任一方式安装并可运行。
-
打开Cursor编辑器,进入
Settings->MCP Servers。 -
点击
Add new MCP server。 -
选择
Command类型。 -
在配置框中填入:
-
Command:
node -
Args:
[/path/to/software-planning-tool/build/index.js]
请将/path/to/替换为实际的全局安装路径,例如/usr/local/lib/node_modules/@zhangzhixiong/software-planning-tool/build/index.js,或使用项目克隆后的本地路径。
-
-
保存配置。Cursor 将在后台自动启动该MCP服务器。
安装常见问题与修复
-
npm install失败:通常是网络问题。可尝试切换npm镜像源:npm install --registry=https://registry.npmmirror.com。 -
Cursor/Claude 无法连接:
-
确认MCP服务器已正确启动。可以在终端手动运行启动命令,看是否有报错。
-
检查客户端配置中的命令和路径是否完全正确。
-
确保没有端口冲突。某些版本可能支持通过环境变量
SOFTWARE_PLANNING_PORT修改默认端口。
-
-
如何重置数据:删除存储在用户目录下的数据文件(通常是
~/.software-planning-tool/data.json)即可重置。
3. 配套客户端
Software Planning Tool 本身没有独立界面,它作为“引擎”,需要搭载在以下支持MCP协议的“AI客户端”中使用:
-
Cursor:这是一款集成了强大AI的代码编辑器,对MCP支持良好,是使用本工具最流行的方式之一。
-
是否付费:Cursor提供免费版,高级功能需付费。
-
配置方式:如上文“安装与配置”部分所述,在Settings中配置MCP Server即可。
-
-
Claude Desktop:Anthropic官方发布的Claude客户端,同样支持配置MCP服务器。
-
是否付费:应用免费,但使用Claude模型可能需要API费用或订阅。
-
配置方式:通过编辑其JSON配置文件添加MCP服务器设置。
-
-
其他MCP客户端:任何遵循Model Context Protocol的客户端理论上均可集成。
4. 案例讲解:规划一个个人博客网站
让我们模拟一个真实场景:“我想开发一个个人技术博客网站”。
第1步:启动规划会话
在配置好MCP的Cursor或Claude中,你可以直接用自然语言对话启动:
“请使用Software Planning Tool,帮我规划一个个人技术博客网站的开发,主要用来分享编程笔记,希望有文章列表、分类和暗色模式。”
AI助手(调用 start_planning 工具)会记录这个目标,并开启一个规划会话。
第2步:拆解任务与细化需求
接着,AI会引导你或自动开始添加具体任务。例如,它可能会生成第一个任务并征求你的同意:
“我来添加第一个核心任务:‘项目初始化与基础框架搭建’。描述:创建Next.js项目,配置TypeScript、ESLint和项目基本结构。复杂度设为2(低)。优先级设为high。可以吗?”
在你确认后,AI会调用 add_todo 工具将该任务加入计划。以下是一个添加任务时可能涉及的代码示例结构:
// 这是在AI调用工具时传递的底层参数示例,用户通常通过自然语言交互即可 { title: “实现文章详情页”, description: “开发动态路由页面 `/blog/[slug]`,从Markdown文件解析元数据和内容,并渲染样式。”, complexity: 4, priority: “high”, tags: [“前端”, “页面”], dependencies: [“项目初始化与基础框架搭建”, “Markdown解析模块设计”], // 依赖的其他任务ID codeExample: `// 示例:getStaticPaths 和 getStaticProps 的实现逻辑…` }
第3步:完善计划与调整
通过持续的对话,你可以要求AI:“把后台管理的任务也加进去”,或者“将‘设计数据库模式’这个任务拆得更细一点”。AI会相应地调用 add_todo、remove_todo 或 update_todo_status 等工具来调整计划。
第4步:查看与导出
规划完毕后,你可以说:“请给我看一下所有的待办任务。” AI会调用 get_todos 工具,并以清晰的表格形式列出所有任务,包括其状态、优先级和负责人。
最终,你可以要求 “导出完整的开发计划” ,AI会通过 export_plan 工具提供一个JSON文件,你可以保存下来,作为后续开发的精确路线图。
5. 使用成本与商业价值评估
使用成本
-
直接金钱成本:¥0。该工具是开源项目,采用MIT许可证,无论是个人还是商业用途,都无需支付任何授权费用。
-
间接成本:
-
学习成本:需要花一些时间了解MCP概念及客户端(如Cursor)的配置方法。
-
时间成本:与AI进行规划对话本身需要时间,但这通常远少于自行梳理规划的时间。
-
环境成本:需要安装Node.js和合适的AI客户端。
-
商业价值与收益
-
提升规划质量与效率:工具强制进行结构化思考,能有效避免任务遗漏,尤其对于复杂项目,可将传统的数天规划时间缩短至数小时。
-
降低项目管理门槛:个人开发者或小团队无需购买或学习像Jira、Microsoft Project(企业版每用户每月成本从$10到$55不等)这样复杂且昂贵的专业软件,即可获得AI强化的规划能力。
-
无缝融入开发流:在AI编码助手内部完成规划,实现了“规划-编码”上下文的统一,减少工具间切换的摩擦。
-
知识沉淀:导出的结构化计划本身就是极佳的项目文档,记录了为什么做出这样的技术决策和任务分解。
总结:Software Planning Tool 是一款极具特色的、AI原生的敏捷规划工具。它将项目规划的负担从开发者肩上部分卸下,交给了更擅长结构分解的AI。对于它的目标用户——个人开发者、创业团队或敏捷小队而言,其零金钱成本和显著提升的启动效率带来了极高的性价比。当然,它的价值上限很大程度上取决于你所使用的AI助手的能力以及你与之协作的熟练度。如果你已经使用Cursor或Claude进行开发,那么集成这个工具,无疑是让你的开发工作流变得更加智能和系统化的下一步。

关注 “悠AI” 更多干货技巧行业动态