Software Planning Tool MCP server

The Software Planning Tool is a Model Context Protocol (MCP) server that helps with software development planning through an interactive approach. It breaks down complex projects into manageable tasks, tracks implementation progress, and maintains detailed development plans - all in a structured format that integrates with AI assistants.

Installation Options

Via Smithery (Automated Installation)

For Claude Desktop users, you can install the Software Planning Tool automatically:

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

Manual Installation

If you prefer to install manually:

1. Clone the repository
2. Install dependencies:

   pnpm install
   

3. Build the project:

   pnpm run build
   

4. Configure your MCP settings by adding the following to your configuration file (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": []
       }
     }
   }
   

Using the Software Planning Tool

The Software Planning Tool provides several functions to manage development planning. Here's how to use each one:

Starting a Planning Session

To begin planning for a new software project:

await client.callTool("software-planning-tool", "start_planning", {
  goal: "Create a React-based dashboard application"
});

Managing Tasks

Adding Todo Items

Add new tasks to your plan with detailed information:

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
  `
});

Getting All Todos

Retrieve all tasks in your current plan:

const todos = await client.callTool("software-planning-tool", "get_todos");

Updating Todo Status

Mark tasks as complete or incomplete:

await client.callTool("software-planning-tool", "update_todo_status", {
  todoId: todo.id,
  isComplete: true
});

Removing Todos

Remove a task from your plan:

await client.callTool("software-planning-tool", "remove_todo", {
  todoId: todo.id
});

Saving Implementation Plans

Save your complete implementation plan with structured phases and details:

await client.callTool("software-planning-tool", "save_plan", {
  plan: `
# Dashboard Implementation Plan

## Phase 1: Setup (Complexity: 3)
- Initialize React project
- Install dependencies
- Set up routing

## Phase 2: Core Features (Complexity: 5)
- Implement authentication
- Create dashboard layout
- Add data visualization components
  `
});

Complete Example Workflow

Here's a typical workflow using all the major features:

1. Start your planning session with a clear goal
2. Add detailed todo items with complexity scores and code examples
3. Review your list of todos
4. Update completion status as you progress
5. Remove any tasks that are no longer needed
6. Save your complete implementation plan for reference

This structured approach ensures your software development process is well-organized, with clear tasks and implementation details that both developers and stakeholders can understand.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.