Skip to content
Back to search

Software-planning-mcp

An experiment in software planning using MCP

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nighttrek--software-planning-mcp/badge.svg)](/listings/nighttrek--software-planning-mcp)

HTML

<a href="/listings/nighttrek--software-planning-mcp"><img src="/api/listings/nighttrek--software-planning-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install Software Planning Tool for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@NightTrek/Software-planning-mcp):

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

Manual Installation

1. Clone the repository 2. Install dependencies:

pnpm install

3. Build the project:

pnpm run build

4. Add to your MCP settings configuration (typically located at `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`):

{
  "mcpServers": {
    "software-planning-tool": {
      "command": "node",
      "args": [
        "/path/to/software-planning-tool/build/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 192 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Software Planning Tool 🚀 (Deprecated)
  2. > [!WARNING]
  3. > **Deprecated and no longer maintained.** The source and manual installation instructions remain available for reference.
  4. [![smithery badge](https://smithery.ai/badge/@NightTrek/Software-planning-mcp)](https://smithery.ai/server/@NightTrek/Software-planning-mcp)
  5. A Model Context Protocol (MCP) server designed to facilitate software development planning through an interactive, structured approach. This tool helps break down complex software projects into manageable tasks, track implementation progress, and maintain detailed development plans.
  6. <a href="https://glama.ai/mcp/servers/a35c7qc7ie">
  7. <img width="380" height="200" src="https://glama.ai/mcp/servers/a35c7qc7ie/badge" alt="Software Planning Tool MCP server" />
  8. </a>
  9. ## Features ✨
  10. - **Interactive Planning Sessions**: Start and manage development planning sessions
  11. - **Todo Management**: Create, update, and track development tasks
  12. - **Complexity Scoring**: Assign complexity scores to tasks for better estimation
  13. - **Code Examples**: Include relevant code snippets in task descriptions
  14. - **Implementation Plans**: Save and manage detailed implementation plans
  15. ## Installation 🛠️
  16. For existing users who still need to run this unmaintained project, use the manual/local setup below rather than Smithery.
  17. ### Manual / Local Installation
  18. 1. Clone the repository
  19. 2. Install dependencies:
  20. ```bash
  21. pnpm install
  22. ```
  23. 3. Build the project:
  24. ```bash
  25. pnpm run build
  26. ```
  27. 4. Add to your MCP settings configuration (typically located at `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`):
  28. ```json
  29. {
  30. "mcpServers": {
  31. "software-planning-tool": {
  32. "command": "node",
  33. "args": [
  34. "/path/to/software-planning-tool/build/index.js"
  35. ],
  36. "disabled": false,
  37. "autoApprove": []
  38. }
  39. }
  40. }
  41. ```
  42. ### Smithery installation notice
  43. The previous Smithery CLI installation route is no longer recommended. Smithery is [shutting down its connection management services](https://www.smithery.ai/future) on **October 31, 2026** and deprecating its current CLI and SDK versions. Smithery remains a public, non-proxied MCP registry; use the manual/local setup above instead of the former Smithery install command.
  44. ## Available Tools 🔧
  45. ### start_planning
  46. Start a new planning session with a specific goal.
  47. ```typescript
  48. {
  49. goal: string // The software development goal to plan
  50. }
  51. ```
  52. ### add_todo
  53. Add a new todo item to the current plan.
  54. ```typescript
  55. {
  56. title: string, // Title of the todo item
  57. description: string, // Detailed description
  58. complexity: number, // Complexity score (0-10)
  59. codeExample?: string // Optional code example
  60. }
  61. ```
  62. ### get_todos
  63. Retrieve all todos in the current plan.
  64. ```typescript
  65. // No parameters required
  66. ```
  67. ### update_todo_status
  68. Update the completion status of a todo item.
  69. ```typescript
  70. {
  71. todoId: string, // ID of the todo item
  72. isComplete: boolean // New completion status
  73. }
  74. ```
  75. ### save_plan
  76. Save the current implementation plan.
  77. ```typescript
  78. {
  79. plan: string // The implementation plan text
  80. }
  81. ```
  82. ### remove_todo
  83. Remove a todo item from the current plan.
  84. ```typescript
  85. {
  86. todoId: string // ID of the todo item to remove
  87. }
  88. ```
  89. ## Example Usage 📝
  90. Here's a complete example of using the software planning tool:
  91. 1. Start a planning session:
  92. ```typescript
  93. await client.callTool("software-planning-tool", "start_planning", {
  94. goal: "Create a React-based dashboard application"
  95. });
  96. ```
  97. 2. Add a todo item:
  98. ```typescript
  99. const todo = await client.callTool("software-planning-tool", "add_todo", {
  100. title: "Set up project structure",
  101. description: "Initialize React project with necessary dependencies",
  102. complexity: 3,
  103. codeExample: `
  104. npx create-react-app dashboard
  105. cd dashboard
  106. npm install @material-ui/core @material-ui/icons
  107. `
  108. });
  109. ```
  110. 3. Update todo status:
  111. ```typescript
  112. await client.callTool("software-planning-tool", "update_todo_status", {
  113. todoId: todo.id,
  114. isComplete: true
  115. });
  116. ```
  117. 4. Save the implementation plan:
  118. ```typescript
  119. await client.callTool("software-planning-tool", "save_plan", {
  120. plan: `
  121. # Dashboard Implementation Plan
  122. ## Phase 1: Setup (Complexity: 3)
  123. - Initialize React project
  124. - Install dependencies
  125. - Set up routing
  126. ## Phase 2: Core Features (Complexity: 5)
  127. - Implement authentication
  128. - Create dashboard layout
  129. - Add data visualization components
  130. `
  131. });
  132. ```
  133. ## Development 🔨
  134. ### Project Structure
  135. ```
  136. software-planning-tool/
  137. ├── src/
  138. │ ├── index.ts # Main server implementation
  139. │ ├── prompts.ts # Planning prompts and templates
  140. │ ├── storage.ts # Data persistence
  141. │ └── types.ts # TypeScript type definitions
  142. ├── build/ # Compiled JavaScript
  143. ├── package.json
  144. └── tsconfig.json
  145. ```
  146. ### Building
  147. ```bash
  148. pnpm run build
  149. ```
  150. ### Testing
  151. Test all features using the MCP inspector:
  152. ```bash
  153. pnpm run inspector
  154. ```
  155. ## License 📄
  156. MIT
  157. ---
  158. Made with ❤️ using the Model Context Protocol

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.