Home / MCP / Software Planning MCP Server

Software Planning MCP Server

Provides interactive planning sessions, todo management, complexity scoring, and implementation plan storage for software projects.

typescript

392stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can use this MCP server to run interactive planning sessions for software projects. It helps break down work into actionable tasks, assign complexity, attach code examples, and save detailed implementation plans, all within an MCP-enabled client.

How to use

Begin a planning session by setting a clear software goal. Create todos that describe concrete tasks, attach descriptions, assign a complexity score, and optionally include a code example to illustrate implementation details. Retrieve all current tasks to review progress, update the completion status of items as you work, and save your full implementation plan when you’re ready to share or reference later. You can remove items you decide are unnecessary and keep your plan focused and actionable.

Typical workflow you can follow in your MCP client: start planning with a goal, add multiple todos with descriptions and complexity, periodically fetch the list of todos to monitor progress, mark tasks as complete as you finish them, save a cohesive implementation plan, and prune any outdated tasks. This approach helps you maintain an organized, auditable road map from concept to deployment.

How to install

Prerequisites you need before installing: Node.js and a package manager. You will also need access to your MCP client configuration area to register the server so you can connect and run it.

Option A: Installing via Smithery (automatic)

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

Option B: Manual installation (clone, install, build, configure)

1. Clone the repository
2. Install dependencies:
   pnpm install
3. Build the project:
   pnpm run build
4. Add to your MCP settings configuration
   {
     "mcpServers": {
       "software-planning-tool": {
         "command": "node",
         "args": [
           "/path/to/software-planning-tool/build/index.js"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }

Additional notes

The manual installation flow culminates in registering a local server entry that runs the compiled index.js with Node. Use the exact path to the built file on your system when configuring your MCP client.

Available tools

start_planning

Starts a new planning session with a specific goal to guide the planning process.

add_todo

Adds a new todo item to the current plan with title, description, complexity score, and optional code example.

get_todos

Retrieves all todos in the current planning session.

update_todo_status

Updates the completion status of a todo item by its identifier.

save_plan

Saves the current implementation plan as a textual artifact for future reference.

remove_todo

Removes a todo item from the current planning session.