软件规划工具 🚀

这是一个设计用于通过交互式、结构化方法促进软件开发规划的模型上下文协议（MCP）服务器。此工具可帮助将复杂的软件项目分解为可管理的任务，跟踪实施进度，并维护详细的开发计划。

功能 ✨

• 交互式规划会话：启动和管理开发规划会话
• 待办事项管理：创建、更新和跟踪开发任务
• 复杂度评分：为任务分配复杂度分数以更好地进行估算
• 代码示例：在任务描述中包含相关代码片段
• 实施计划：保存和管理详细的实施计划

安装 🛠️

通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面安装软件规划工具：

bash
npx -y @smithery/cli install @NightTrek/Software-planning-mcp --client claude

手动安装

1. 克隆仓库

2. 安装依赖项：
   bash
   pnpm install

3. 构建项目：
   bash
   pnpm run build

4. 将其添加到您的 MCP 设置配置中（通常位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：
   json
   {
   "mcpServers": {
   "software-planning-tool": {
   "command": "node",
   "args": [
   "/path/to/software-planning-tool/build/index.js"
   ],
   "disabled": false,
   "autoApprove": []
   }
   }
   }

可用工具 🔧

start_planning

开始一个具有特定目标的新规划会话。
typescript
{
goal: string // 要规划的软件开发目标
}

add_todo

向当前计划添加一个新的待办事项。
typescript
{
title: string, // 待办事项标题
description: string, // 详细描述
complexity: number, // 复杂度分数 (0-10)
codeExample?: string // 可选代码示例
}

get_todos

检索当前计划中的所有待办事项。
typescript
// 不需要参数

update_todo_status

更新待办事项的完成状态。
typescript
{
todoId: string, // 待办事项 ID
isComplete: boolean // 新的完成状态
}

save_plan

保存当前的实施计划。
typescript
{
plan: string // 实施计划文本
}

remove_todo

从当前计划中移除一个待办事项。
typescript
{
todoId: string // 要移除的待办事项 ID
}

使用示例 📝

以下是一个使用软件规划工具的完整示例：

1. 启动一个规划会话：
   typescript
   await client.callTool("software-planning-tool", "start_planning", {
   goal: "创建基于 React 的仪表板应用程序"
   });

2. 添加一个待办事项：
   typescript
   const todo = await client.callTool("software-planning-tool", "add_todo", {
   title: "设置项目结构",
   description: "初始化带有必要依赖项的 React 项目",
   complexity: 3,
   codeExample: npx create-react-app dashboard cd dashboard npm install @material-ui/core @material-ui/icons
   });

3. 更新待办事项状态：
   typescript
   await client.callTool("software-planning-tool", "update_todo_status", {
   todoId: todo.id,
   isComplete: true
   });

4. 保存实施计划：
   typescript
   await client.callTool("software-planning-tool", "save_plan", {
   plan: `

仪表板实施计划

阶段 1：设置 (复杂度: 3)

• 初始化 React 项目
• 安装依赖项
• 设置路由

阶段 2：核心功能 (复杂度: 5)

• 实现身份验证
• 创建仪表板布局
• 添加数据可视化组件
  `
  });## 开发 🔨

项目结构

plaintext
software-planning-tool/
├── src/
│ ├── index.ts # 主服务器实现
│ ├── prompts.ts # 规划提示和模板
│ ├── storage.ts # 数据持久化
│ └── types.ts # TypeScript 类型定义
├── build/ # 编译后的 JavaScript
├── package.json
└── tsconfig.json

构建

bash
pnpm run build

测试

使用 MCP 检查器测试所有功能：
bash
pnpm run inspector

许可证 📄

MIT

用 ❤️ 和 Model Context Protocol 制作