Project Planner MCP

MCP-Server für strukturierte Laravel-Projektplanung. Scannt dein Projekt, erstellt Tickets, exportiert als JSON.

inspect → plan → export → GitLab/Todoist

Installation

Via Claude Code (empfohlen)

claude mcp add project-planner -- npx @brnbio/project-planner-mcp

Manuell in ~/.claude.json

{
  "mcpServers": {
    "project-planner": {
      "command": "npx",
      "args": ["@brnbio/project-planner-mcp"]
    }
  }
}

Dann Claude Code neustarten.

Usage

Schritt 1: Projekt analysieren

Navigiere in dein Laravel-Projekt und starte Claude Code:

cd /pfad/zu/deinem/laravel-projekt
claude

Dann:

> Analysiere das Projekt.
> Aktueller Stand: Auth funktioniert, Dashboard ist leer
> Ziel: User können Zeiten erfassen und sehen eine Wochen-Übersicht

Claude nutzt inspect und scannt automatisch:

• Models + Relations
• Migrations (DB-Schema)
• Controllers + Methods
• Routes
• Vue Pages & Components

Output: project_context.json

Schritt 2: Tickets planen

> Plane die Umsetzung

Claude analysiert den Gap zwischen IST und SOLL, stellt Rückfragen:

• Welche Entitäten werden benötigt?
• Wie hängen sie zusammen?
• Was ist der MVP?

Dann generiert er Tickets mit 4h/8h Schätzungen.

Output: tickets_draft.json

Schritt 3: Tickets exportieren

> Exportiere die Tickets

Review der Ticket-Liste, dann Bestätigung.

Output: tickets_final.json

[
  {
    "title": "TimeEntry Model + Migration",
    "description": "Erstelle TimeEntry Model mit user_id, started_at, ended_at, description.\n\n## Checkliste\n- [ ] Migration erstellen\n- [ ] Model mit Fillables\n- [ ] Factory erstellen\n- [ ] Relation zu User",
    "estimate": "4h",
    "labels": ["Backend", "Database"]
  }
]

Schritt 4: Issues erstellen (optional)

Mit deinen bestehenden MCPs:

> Erstelle GitLab Issues aus tickets_final.json
> Erstelle Todoist Tasks aus tickets_final.json

Tools

| Tool | Input | Output | |------|-------|--------| | inspect | currentState, targetState | project_context.json | | plan | (clarifications) | tickets_draft.json | | export | confirm: true | tickets_final.json |

Output-Dateien

Alle Dateien landen im Projektverzeichnis und können versioniert werden:

dein-laravel-projekt/
├── project_context.json   # IST + SOLL + Analyse
├── tickets_draft.json     # Entwürfe
├── tickets_final.json     # Finale Tickets
└── ...

Tipp: Füge die JSON-Dateien zum Git hinzu als Planungs-Dokumentation.

Ticket-Schema

interface Ticket {
  title: string;
  description: string;      // Mit Markdown-Checkliste
  estimate: "4h" | "8h";
  labels: ("Backend" | "Frontend" | "Testing" | "Database")[];
}

Tech Stack

Optimiert für:

• Laravel 12 + Inertia.js v2
• Vue 3 Composition API
• PestPHP
• Tailwind CSS

Publishing (für Maintainer)

npm login
npm publish --access public

Lizenz

MIT