Software Planning MCP

An MCP server tool for software development planning and task management

Developer tools Knowledge management and memory #Software development #Task management #Planning tool #MCP service .Python

rating : 2 points

downloads : 7.1K

update time : 2025-04-28

Open Site

What is the Software Planning MCP Server?

The Software Planning MCP Server is a tool that helps you plan software development projects. By setting goals, formulating implementation plans, and managing to - do items, it improves team collaboration efficiency.

How to use the Software Planning MCP Server?

You just need to start the server and configure the connection through the Cursor editor, then you can start creating goals, formulating plans, and tracking task progress.

Applicable Scenarios

Suitable for teams and individuals who need systematic software development planning, especially for multi - person collaborative projects.

Main Features

Create Software Development Goals

Easily set the overall goals of software development and clarify the direction.

Formulate Detailed Implementation Plans

Refine the goals and formulate implementation plans step by step.

Manage the To - Do List

Add, delete, or update tasks at any time to ensure the orderly progress of tasks.

Track Task Completion Status

View task progress in real - time and keep track of the overall development situation.

Provide a Structured Thinking Process

Help users form a clear thinking framework and improve decision - making quality.

Advantages

Improve team collaboration efficiency

Facilitate task management and progress tracking

Support custom extensions

Open - source and free

Limitations

Have certain requirements for the network environment

Advanced functions may require a certain learning cost

How to Use

Install the Software Planning MCP Server

Clone the repository and install the dependencies according to the instructions.

Start the Server

Run the command to start the MCP server.

Configure the Server in Cursor

Go to the Cursor settings page and add the MCP server configuration.

Usage Examples

Case 1: Create a Goal and Add Tasks

First, set the goal, and then gradually add specific tasks.

Case 2: Update Task Status

Mark a certain task as completed.

Frequently Asked Questions

How to solve the problem that Cursor cannot connect?

How to modify the default port number?

Related Resources

Official GitHub Repository

Get the latest version and documentation.

User Manual

Learn the usage methods in - depth.

🚀 Software Planning MCP Server

A Python-based fixed version of the Software Development Planning MCP Server that supports connecting to Cursor via the SSE protocol. This MCP server provides a set of tools and features to help users set software development goals, formulate implementation plans, and manage to-do lists.

🚀 Quick Start

This MCP server offers a suite of tools and features to assist users in setting software development goals, formulating implementation plans, and managing to-do lists.

✨ Features

Create Software Development Goals: Users can define clear software development goals.
Formulate Detailed Implementation Plans: Provide a structured approach to plan the specific steps of a project.
Manage To-Do Lists: Support adding, updating, and tracking the status of to-do items.
Track Task Completion Status: Enable real-time viewing of the completion status of each task.
Provide a Structured Thinking Process: Assist users in project planning in a systematic manner.

📦 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  # Run on Linux/Mac
# Or run on Windows
.venv\Scripts\activate 

# Install dependencies
pip install -e .

💻 Usage Examples

Start the Server

# Use the SSE transmission 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 transmission 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.

Basic Usage

# Use the start_planning tool
response = client.start_planning(goal="Develop a simple to-do list manager")

# Use the save_plan tool
response = client.save_plan(plan="Phase 1: Requirement analysis; Phase 2: Design; Phase 3: Implementation; Phase 4: Testing and optimization")

# Use the add_todo tool
response = client.add_todo(
    title="Complete project documentation",
    description="Write user manuals and technical documents",
    complexity=2,
    code_example="example_code()"
)

# Use the remove_todo tool
response = client.remove_todo(todo_id="12345")

# Use the get_todos tool
todos = client.get_todos()

# Use the update_todo_status tool
response = client.update_todo_status(
    todo_id="12345",
    is_complete=True  # Or pass the string "True"
)

📚 Documentation

Available Tools

Property	Details
start_planning	Start a new planning session and set goals. Parameters: goal (string): Software development goal.
save_plan	Save the current implementation plan. Parameters: plan (string): Implementation plan text.
add_todo	Add a new to-do item to the current plan. Parameters: title (string): Title; description (string): Description; complexity (integer between 0 - 10): Complexity; code_example (optional, string): Code example.
remove_todo	Remove a to-do item from the current plan. Parameters: todo_id (string): To-do item ID.
get_todos	Get all to-do items in the current plan. Parameters: None.
update_todo_status	Update the completion status of a to-do item. Parameters: todo_id (string): To-do item ID; is_complete (boolean or corresponding string, e.g., "True"/"False"): 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 transmission protocol (default: sse, optional values are sse or stdio).

Notes

⚠️ Important Note

Type Conversion: In the fixed version, the tool interfaces perform necessary type conversions on input parameters. For example, for the update_todo_status tool, the is_complete parameter can be a boolean or its corresponding string form (e.g., "True" or "False").

Error Handling: If the format of the passed parameters does not meet the requirements, the server will return corresponding error messages and suggest how to correct them.

Documentation Update

The type mismatch issue in the previous version has been fixed. Now, both boolean values and their corresponding string forms can be passed to the update_todo_status tool.

```markdown
## 🚀 Software Planning MCP Server

*A Python-based fixed version of the Software Development Planning MCP Server that supports connecting to Cursor via the SSE protocol. This MCP server provides a set of tools and features to help users set software development goals, formulate implementation plans, and manage to-do lists.*

## 🚀 Quick Start

This MCP server offers a suite of tools and features to assist users in setting software development goals, formulating implementation plans, and managing to-do lists.

## ✨ Features

- **Create Software Development Goals**: Users can define clear software development goals.
- **Formulate Detailed Implementation Plans**: Provide a structured approach to plan the specific steps of a project.
- **Manage To-Do Lists**: Support adding, updating, and tracking the status of to-do items.
- **Track Task Completion Status**: Enable real-time viewing of the completion status of each task.
- **Provide a Structured Thinking Process**: Assist users in project planning in a systematic manner.

## 📦 Installation

```bash
# 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  # Run on Linux/Mac
# Or run on Windows
.venv\Scripts\activate 

# Install dependencies
pip install -e .

💻 Usage Examples

Start the Server

# Use the SSE transmission 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 transmission 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.

Basic Usage

# Use the start_planning tool
response = client.start_planning(goal="Develop a simple to-do list manager")

# Use the save_plan tool
response = client.save_plan(plan="Phase 1: Requirement analysis; Phase 2: Design; Phase 3: Implementation; Phase 4: Testing and optimization")

# Use the add_todo tool
response = client.add_todo(
    title="Complete project documentation",
    description="Write user manuals and technical documents",
    complexity=2,
    code_example="example_code()"
)

# Use the remove_todo tool
response = client.remove_todo(todo_id="12345")

# Use the get_todos tool
todos = client.get_todos()

# Use the update_todo_status tool
response = client.update_todo_status(
    todo_id="12345",
    is_complete=True  # Or pass the string "True"
)

📚 Documentation

Available Tools

Property	Details
start_planning	Start a new planning session and set goals. Parameters: goal (string): Software development goal.
save_plan	Save the current implementation plan. Parameters: plan (string): Implementation plan text.
add_todo	Add a new to-do item to the current plan. Parameters: title (string): Title; description (string): Description; complexity (integer between 0 - 10): Complexity; code_example (optional, string): Code example.
remove_todo	Remove a to-do item from the current plan. Parameters: todo_id (string): To-do item ID.
get_todos	Get all to-do items in the current plan. Parameters: None.
update_todo_status	Update the completion status of a to-do item. Parameters: todo_id (string): To-do item ID; is_complete (boolean or corresponding string, e.g., "True"/"False"): 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 transmission protocol (default: sse, optional values are sse or stdio).

Notes

⚠️ Important Note

Type Conversion: In the fixed version, the tool interfaces perform necessary type conversions on input parameters. For example, for the update_todo_status tool, the is_complete parameter can be a boolean or its corresponding string form (e.g., "True" or "False").

Error Handling: If the format of the passed parameters does not meet the requirements, the server will return corresponding error messages and suggest how to correct them.

Documentation Update

The type mismatch issue in the previous version has been fixed. Now, both boolean values and their corresponding string forms can be passed to the update_todo_status tool.