Mcp Server Zplanner

zPlanner v1.4.0

zPlanner is a command-line tool developed to assist in project planning and management, with a special focus on software development projects. The project was born from the need to have a simple yet powerful tool that would allow project management directly from the terminal, without the need for complex graphical interfaces.

One of zPlanner’s main differentiators is its ability to function as a memory system for AI-assisted development in IDEs with prompt capabilities. By maintaining a structured and hierarchical project record, ZPlanner helps preserve development context, allowing AI assistants to better understand the project’s structure, history, and current state, resulting in more accurate and contextualized suggestions and assistance.

Purpose

zPlanner was created with the following objectives:

Simplicity: Enable project management directly from the terminal
Efficiency: Minimize time spent on administrative tasks
Flexibility: Adapt to different project types and methodologies
Visualization: Generate clear and responsive HTML reports
Traceability: Maintain progress history and updates
AI Context: Function as a memory system for AI-assisted development, maintaining structured project context

AI First Design

zPlanner was designed with modern AI-assisted development in mind:

Context Preservation: Maintains a structured history that serves as memory for AI assistants
Hierarchical Structure: Organization that facilitates project understanding by AI systems
Change Tracking: Allows AI assistants to understand project evolution
Clear Documentation: Standardized format that improves interpretation by AI systems

Features

Project Management

Project creation and configuration
Hierarchical structure (phases, tasks, and subtasks)
Automatic progress calculation
Responsive HTML export
Update date tracking

Phase Organization

Project phase creation
Phase reordering
Phase renaming
Phase removal
Progress calculation per phase

Task Management

Main task addition
Subtask creation
Completion marking
Description updates
Task removal

HTML Reports

Modern and responsive design
Clear hierarchy visualization
Progress indicators
Update history
Professional styling with BEM CSS

Installation

npm install -g zplanner

Usage Guide

Basic Commands

Project Management

## Initialize new project
zplanner init "Project Name"

## List project structure
zplanner list

## Export HTML report
zplanner export ./path/report.html

Phase Management

## Add phase
zplanner add-phase "Phase Name"

## Rename phase
zplanner rename-phase "Current Name" "New Name"

## Move phase
zplanner move-phase "Phase Name" 2

## Remove phase
zplanner remove-phase "Phase Name"

Task Management

## Add task
zplanner add-task "Phase" "1.1" "Task Description"

## Add subtask
zplanner add-subtask "Phase" "1.1" "1.1.1" "Subtask Description"

## Mark as complete
zplanner complete "Phase" "1.1"

## Update description
zplanner update-task "Phase" "1.1" "New Description"

## Remove task
zplanner remove-task "Phase" "1.1"

Project Structure

The project is organized as follows:

zPlanner/
├── src/
│   ├── cli.ts                 # Command-line interface
│   ├── index.ts              # Main entry point
│   ├── ProjectPlanner.ts     # Core project management
│   ├── config/              # Project configurations
│   ├── services/            # Business services
│   │   ├── PhaseService.ts  # Phase management
│   │   ├── TaskService.ts   # Task management
│   │   └── progress/        # Progress calculation
│   └── templates/           # HTML and CSS templates
├── dist/                    # Compiled code
└── docs/                    # Documentation

Development

Prerequisites

Node.js >= 14.0.0
npm >= 6.0.0

Environment Setup

## Clone repository
git clone https://github.com/cyllas/zPlanner.git

## Install dependencies
cd zPlanner
npm install

## Run tests
npm test

## Start development mode
npm run dev

Configuration

The settings.ts file allows configuration of:

export const settings = {
  defaultLanguage: "en-US",
  dateFormat: "MM/DD/YYYY",
  timeZone: "UTC",
  projectDefaults: {
    outputFormat: "html",
    indentSize: 2,
  },
  repository: {
    url: "https://github.com/cyllas/zPlanner",
  },
  version: "1.4.0",
};