software-planning-mcp

# Software Planning MCP Server https://github.com/NightTrek/Software-planning-mcp This is a Python (fixed version) project that facilitates the integration of cursor using SSE. This MCP server provides a software development planning tool to help users create 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 ```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 # Linux/Mac # or .venv\Scripts\activate # Windows # Install dependencies pip install -e . ``` ## Usage ### Start the Server ```bash # Use 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 stdio transport protocol (for command line testing) python server.py --transport stdio --debug ``` ### Configure MCP Server in Cursor 1. Open the Cursor editor 2. Go to Settings -> MCP Servers 3. Click "Add new MCP server" 4. Enter the server link: `http://localhost:8000/sse` (modify accordingly if using a custom port) 5. Save the configuration ## Available Tools | Tool Name | Description | Parameters | |------------------|-----------------------------------------------|---------------------------------------------------------------------------| | start_planning | Start a new planning session, set goals | goal: Software development goal | | save_plan | Save the current implementation plan | plan: Implementation plan text | | add_todo | Add a new to-do item to the current plan | title: Title<br>description: Description<br>complexity: Complexity (0-10)<br>code_example: Code example (optional) | | remove_todo | Remove a to-do item from the current plan | todo_id: To-do item ID | | get_todos | Retrieve all to-do items in the current plan | None | | update_todo_status | Update the completion status of a to-do item | todo_id: To-do item ID<br>is_complete: Completion status | ## Available Resources | Resource URI | Description | |----------------------------------|--------------------------------------| | planning://current-goal | Current software development goal | | planning://implementation-plan | Current implementation plan and to-dos | ## 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, options are "stdio" or "sse" (default: "sse") - `SOFTWARE_PLANNING_DEBUG`: Enable debug mode, options are "true", "1", or "yes" (default: disabled) ## Update In the Python version at https://github.com/CaptainJi/software_planning_mcp.git, when executing the update_todo_status tool, Cursor always passes a numeric type, but the original version requires a string type, which causes errors. This has been specifically fixed. ## License MIT