MCP 服务器

Project Planner MCP

MCP server for structured Laravel project planning. Scans projects, creates tickets, and exports as JSON.

README

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")[];
}