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/nighttrek/software-planning-mcp and has 396 stars.
Related MCP tools
Web search using free google search (NO API KEYS REQUIRED)
A CLI inspector for the Model Context Protocol
Adb-mcp is a proof of concept project to enabled AI control of Adobe tools (Adobe Photoshop and Adobe Premiere) by providing an interface to LLMs via the MCP...
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
A Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. JavaScript-based implementation.
MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development JavaScript-based implementation.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP