Software Planning

An MCP server for software development planning and management, providing functions such as goal setting, plan formulation, and task tracking

Developer tools Education and learning tools #Development planning #Task management #MCP service #Progress tracking .Python

rating : 2 points

downloads : 8

update time : 2025-04-23

What is the Software Planning MCP Server?

This is a planning assistance tool specifically designed for software development, providing services through the MCP protocol. It helps developers break down large development goals into executable small tasks and track the progress of completion.

How to use the Software Planning MCP Server?

You can start a planning session with simple commands, set development goals, add to - do items, and track progress. It supports seamless integration with the Cursor editor.

Use cases

Suitable for individual developers or small teams to plan software development projects, especially in scenarios where complex functions need to be disassembled into executable tasks.

Main features

Goal planningSet clear software development goals to provide direction for the entire project

Plan formulationBreak down large goals into detailed implementation plans and clarify each step

Task managementCreate, edit, and track to - do items and manage the development progress

Status trackingUpdate the task completion status in real - time to grasp the overall progress of the project

Advantages and limitations

Advantages

A simple and easy - to - use command - line interface

Seamless integration with the Cursor editor

Flexible task management functions

Clear progress visualization

Limitations

Currently only supports two transmission protocols: SSE and stdio

Manual setting is required for task complexity assessment

Lack of team collaboration functions

How to use

Installation and setup

Clone the repository, install dependencies, and create a virtual environment

Start the server

Start the server by selecting a suitable transmission protocol

Configure the Cursor editor

Add the MCP server configuration in Cursor

Usage examples

Plan the development of a web applicationPlan the development of a simple web application from scratch

Update task statusMark completed tasks

Frequently Asked Questions

How to change the server port?

Why can't Cursor connect to the server?

How to view all current to - do items?

Related resources

GitHub repository

Project source code and the latest version

Cursor editor

An AI code editor supporting the MCP protocol

MCP protocol documentation

Official documentation of the Model Context Protocol

🚀 Software Planning MCP Server

This is a Python (fixed version) project from https://github.com/NightTrek/Software-planning-mcp, which facilitates the use of SSE to connect to Cursor. This MCP server offers software development planning tools to assist users in formulating implementation plans and managing to - do lists.

🚀 Quick Start

This MCP server provides software development planning tools to help users formulate implementation plans and manage to - do lists.

✨ Features

Create software development goals.
Develop detailed implementation plans.
Manage to - do lists.
Track task completion status.
Provide a structured thinking process.

📦 Installation

# Clone the repository
git clone https://github.com/Jo-Lion/software-planning-mcp.git
cd software-planning-mcp

# Create and activate a virtual environment
python -m venv .venv

source .venv/bin/activate  # Linux/Mac
# or
.venv\Scripts\activate  # Windows

# Install dependencies
pip install -e .

💻 Usage Examples

Start the Server

# Use the SSE transport protocol (recommended for Cursor integration)
python server.py --debug

# Use a custom port
python server.py --port 9000 --debug

# Use a custom host address
python server.py --host 127.0.0.1 --debug

# Use the stdio transport protocol (for command - line testing)
python server.py --transport stdio --debug

Configure the MCP Server in Cursor

Open the Cursor editor.
Go to Settings -> MCP Servers.
Click "Add new MCP server".
Enter the server link: http://localhost:8000/sse (modify accordingly if you use a custom port).
Save the configuration.

Available Tools

Property	Details
start_planning	Start a new planning session and set the goal. Parameter: goal (Software development goal)
save_plan	Save the current implementation plan. Parameter: plan (Implementation plan text)
add_todo	Add a new to - do item to the current plan. Parameters: title (Title), description (Description), complexity (Complexity, 0 - 10), code_example (Code example, optional)
remove_todo	Remove a to - do item from the current plan. Parameter: todo_id (To - do item ID)
get_todos	Get all to - do items in the current plan. Parameter: None
update_todo_status	Update the completion status of a to - do item. Parameters: todo_id (To - do item ID), is_complete (Completion status)

Available Resources

Property	Details
planning://current - goal	Current software development goal
planning://implementation - plan	Current implementation plan and to - do items

Environment Variables

SOFTWARE_PLANNING_PORT: Set the SSE server port number (Default: 8000).
SOFTWARE_PLANNING_HOST: Set the SSE server host address (Default: 0.0.0.0).
SOFTWARE_PLANNING_TRANSPORT: Set the transport type, available values are "stdio" or "sse" (Default: "sse").
SOFTWARE_PLANNING_DEBUG: Enable debug mode, available values are "true", "1" or "yes" (Default: Disabled).

Update

In the fixed version, when executing the update_todo_status tool, it was found that Cursor always passes a numeric type, while the original version requires a string type. Therefore, a special fix has been made.