MCP-Projektmanager (Terminal + Web + Desktop)

Dieses Projekt unterstützt drei Schnittstellen über ein Backend:

• Terminal-Suite

• REST-API + React-UI

• MCP-stdio-Server

• Optionaler Python-Desktop-Launcher (öffnet Browser zur lokalen App)

Schnellstart

1. Infrastruktur starten: docker compose up -d

2. Schema anwenden: psql postgresql://postgres:postgres@localhost:5432/mcp_pm -f backend/sql/schema.sql

3. Frontend für http://localhost:4000/ erstellen: npm run build

4. API-Server starten: npm run start

Wenn der Frontend-Build fehlt, gibt / eine klare Nachricht mit den nächsten Schritten zurück.

Separate Ausführungsmodi

• Terminal-Suite: npm run terminal

• MCP-stdio-Server: npm run mcp

• Desktop-Launcher (Attach-Modus): npm run desktop

• Desktop-Launcher (Backend automatisch starten): npm run desktop:start

Backend-Workspace-Äquivalente:

• npm --workspace backend run terminal

• npm --workspace backend run mcp

• npm --workspace backend run desktop

• npm --workspace backend run desktop:start

API-Erweiterungen

• GET /api/projects/:id/plans (Filter + Paginierung)

• GET /api/projects/:id/plans/compare?againstVersion=N

• POST /api/plans/:planId/promote-baseline

• POST /api/analysis/summarize-codebase (ordnerweite Zusammenfassung, Beschreibungen pro Datei, Mermaid-Pipeline)

• Feedback-Aktion beinhaltet needs_review

• Optionen zur Strukturgenerierung: profile, dryRun, overwriteStrategy

Dateisystemsicherheit

Dateisystem-Endpunkte sind auf FS_BASE_PATH beschränkt (Standard: das Arbeitsverzeichnis des Backends).