Software-planning-mcp
An experiment in software planning using MCP
Documentation
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 ✨
- 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
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 claudeManual Installation
1. Clone the repository
2. Install dependencies:
pnpm install3. Build the project:
pnpm run build4. 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 requiredupdate_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:
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
`
});Development 🔨
Project Structure
software-planning-tool/
├── src/
│ ├── index.ts # Main server implementation
│ ├── prompts.ts # Planning prompts and templates
│ ├── storage.ts # Data persistence
│ └── types.ts # TypeScript type definitions
├── build/ # Compiled JavaScript
├── package.json
└── tsconfig.jsonBuilding
pnpm run buildTesting
Test all features using the MCP inspector:
pnpm run inspectorLicense 📄
MIT
Made with ❤️ using the Model Context Protocol
Frequently asked questions
What is Software-planning-mcp?
Software-planning-mcp is An experiment in software planning using MCP
How do I install Software-planning-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is Software-planning-mcp open source?
Yes — it is hosted on GitHub at https://github.com/PhilippMT/Software-planning-mcp.
Related MCP tools
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Use any LLMs (Large Language Models) for Deep Research. Support SSE API and MCP server.
Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual interface support (Web UI and Desktop Application) with intelligent environment detection and cross-platform compatibility.
A powerful Zotero AI and MCP plugin with ChatGPT, Gemini 3.7, Claude Fable 5, Claude Opus 5, DeepSeek V4, Grok, OpenRouter, Kimi k3, GLM 5.3, SiliconFlow, GPT-oss, Gemma 4, Qwen 3.8
Connect your browser to AI models. Just use Dia on Chrome, Arc or Firefox.
文颜 MCP Server 可以让 AI 自动将 Markdown 文章排版后发布至微信公众号。
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP