Software Planning Tool

by nighttrek

169 stars

Not rated

GitHub

About

Guides developers through a structured, question-based approach to break down software goals into actionable implementation plans with detailed task lists, complexity scores, and code examples.

Details

Author: nighttrek
Repository: NightTrek/Software-planning-mcp
GitHub stars: 169
License: MIT License
Categories: Productivity, Design, Developer Tools, AI, Infrastructure, Project Management, Frontend, Automation, Other

- Interactive Planning Sessions: Start and manage development planning sessions
- Todo Management: Create, update, and track development tasks
- Complexity Scoring: Assign complexity scores to tasks for better estimation
- Code Examples: Include relevant code snippets in task descriptions
- Implementation Plans: Save and manage detailed implementation plans

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Software Planning Tool

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/software-planning-tool/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

To install Software Planning Tool for Claude Desktop automatically via Smithery:

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

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": []

    }

  }

}

Here's a complete example of using the software planning tool:

1. Start a planning session:

await client.callTool("software-planning-tool", "start_planning", {

  goal: "Create a React-based dashboard application"

});

2. Add a todo item:

const todo = await client.callTool("software-planning-tool", "add_todo", {

  title: "Set up project structure",

  description: "Initialize React project with necessary dependencies",

  complexity: 3,

  codeExample: 

npx create-react-app dashboard

cd dashboard

npm install @material-ui/core @material-ui/icons

  

});

3. Update todo status:

await client.callTool("software-planning-tool", "update_todo_status", {

  todoId: todo.id,

  isComplete: true

});

4. Save the implementation plan:
``typescript await client.callTool("software-planning-tool", "save_plan", { plan:

- Initialize React project
- Install dependencies
- Set up routing

`start_planning`

Start a new planning session with a specific goal. Parameters: goal (string) - The software development goal to plan.

`add_todo`

Add a new todo item to the current plan. Parameters: title (string) - Title of the todo item, description (string) - Detailed description, complexity (number) - Complexity score (0-10), codeExample (optional string) - Optional code example.

`get_todos`

Retrieve all todos in the current plan. No parameters required.

`update_todo_status`

Update the completion status of a todo item. Parameters: todoId (string) - ID of the todo item, isComplete (boolean) - New completion status.

`save_plan`

Save the current implementation plan. Parameters: plan (string) - The implementation plan text.

`remove_todo`

Remove a todo item from the current plan. Parameters: todoId (string) - ID of the todo item to remove.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Software Planning Tool 🚀

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.

Features ✨

Installation 🛠️

Installing via Smithery

To install Software Planning Tool for Claude Desktop automatically via Smithery:

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": []
    }
  }
}

Available Tools 🔧

start_planning

Start a new planning session with a specific goal.

{
  goal: string  // The software development goal to plan
}

add_todo

Add a new todo item to the current plan.

{
  title: string,         // Title of the todo item
  description: string,   // Detailed description
  complexity: number,    // Complexity score (0-10)
  codeExample?: string  // Optional code example
}

get_todos

Retrieve all todos in the current plan.

// No parameters required

update_todo_status

Update the completion status of a todo item.

{
  todoId: string,     // ID of the todo item
  isComplete: boolean // New completion status
}

save_plan

Save the current implementation plan.

{
  plan: string  // The implementation plan text
}

remove_todo

Remove a todo item from the current plan.

{
  todoId: string  // ID of the todo item to remove
}

Example Usage 📝

Here's a complete example of using the software planning tool:

1. Start a planning session:

await client.callTool("software-planning-tool", "start_planning", {

  goal: "Create a React-based dashboard application"

});

2. Add a todo item:

const todo = await client.callTool("software-planning-tool", "add_todo", {

  title: "Set up project structure",

  description: "Initialize React project with necessary dependencies",

  complexity: 3,

  codeExample: 

npx create-react-app dashboard

cd dashboard

npm install @material-ui/core @material-ui/icons

  

});

3. Update todo status:

await client.callTool("software-planning-tool", "update_todo_status", {

  todoId: todo.id,

  isComplete: true

});

4. Save the implementation plan:
``typescript await client.callTool("software-planning-tool", "save_plan", { plan:

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

start_planning

add_todo

get_todos

update_todo_status

save_plan

remove_todo

Claude Desktop / Cursor

Linux

Macos

Windows

Software Planning Tool 🚀

Features ✨

Installation 🛠️

Installing via Smithery

Manual Installation

Available Tools 🔧

start_planning

add_todo

get_todos

update_todo_status

save_plan

remove_todo

Example Usage 📝

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`start_planning`

`add_todo`

`get_todos`

`update_todo_status`

`save_plan`

`remove_todo`