mern-mcp

KI-gestützter MERN-Stack-CRUD-Scaffolder und MCP-Server

mern-mcp ist ein Open-Source-Model-Context-Protocol-(MCP)-Server zum Erstellen vollständiger MERN-Stack-CRUD-Ressourcen in einer bestehenden Codebasis, mit direkter Einrichtungsunterstützung für Claude Code und Codex CLI. Er generiert MongoDB- und Mongoose-Modelle, Express-Services und -Routen, React-Client-Module und die Verdrahtung, die benötigt wird, um neue Ressourcen mit einem sichereren Vorschau-vor-Anwenden-Workflow in eine echte Anwendung einzubinden.

Wenn Sie nach einem MCP-Server für die MERN-Stack-Entwicklung suchen, einem MongoDB-Express-React-Node.js-CRUD-Generator, einem Mongoose-plus-Express-Boilerplate-Generator oder einem React-Admin-Scaffolder, der mit KI-Codierungsassistenten funktioniert, dann ist dieses Repository genau für diesen Anwendungsfall gebaut.

Inhaltsverzeichnis: Warum nützlich · Generierte Dateien · Installation · Konfiguration · Claude Code · Codex CLI · Docker · MCP-Tools · Beispiel · Projektstile · Natürliche Sprache · Vorschau-Workflow · Für wen

Related MCP server: MCP Terminal & Git Server

Warum Dieses Repository Nützlich Ist

Teams brauchen normalerweise keinen weiteren generischen Code-Generator. Sie brauchen ein lokales MCP-Tool, das ein Projekt untersuchen, einer bestehenden Ordnerstruktur folgen, wiederholbare CRUD-Slices erstellen und blinde Schreibvorgänge vermeiden kann. mern-mcp konzentriert sich auf diesen praktischen Workflow.

Selbst wenn Sie bereits MCPs für Next.js, Node.js oder MongoDB haben, helfen diese Tools normalerweise auf Framework- oder Datenbankebene. mern-mcp ist nützlich, weil es den gesamten Ressourcen-Workflow an einer Stelle abwickelt: Modell, Service, Controller, Routen, Validatoren, Client-API, Hooks, Formulare, Listenansichten, Detailansichten und Integrations-Patches. Statt einen Assistenten zu bitten, jede Ebene separat zu verdrahten, kann ein Entwickler einen gesamten CRUD-Slice in einem Durchgang erstellen, den Plan überprüfen und sich schneller der Geschäftslogik zuwenden. Das reduziert repetitive Einrichtungsarbeit, verringert übersehene Integrationsschritte und macht die tägliche Full-Stack-Entwicklung deutlich weniger mühsam.

Es ist besonders nützlich, wenn Sie Folgendes möchten:

• eine MERN-CRUD-API und React-UI aus einem Ressourcen-Schema erstellen

• Mongoose-Modelle, Express-Controller, Services, Routen und Validatoren generieren

• React-Formulare, Listenansichten, Detailansichten, Hooks, gemeinsame Typen und API-Module generieren

• einen MCP-kompatiblen Codierungsassistenten Ressourcen in Ihrem eigenen Repository erstellen lassen

• Dateiänderungen vor dem Anwenden in der Vorschau anzeigen

• generierte Ressourcen im Laufe der Zeit mit Add-Field- und Delete-Workflows verwalten

• Monorepo- oder separate Server- und Client-Projekte unterstützen

Was mern-mcp Generiert

Für jede Ressource kann mern-mcp Folgendes generieren:

• Server-Modelldatei

• Server-Servicedatei

• Server-Controllerdatei

• Server-Routendatei

• Server-Validatordatei, wenn Validierung aktiviert ist

• Auth-Middleware-Datei, wenn JWT-Auth aktiviert ist

• Client-Datei für gemeinsame Typen

• Client-API-Modul

• Client-Daten-Hook

• Client-Formularkomponente

• Client-Listenkomponente

• Client-Detailkomponente

Typische generierte Pfade sehen so aus:

server/models/product.model.ts
server/services/product.service.ts
server/controllers/product.controller.ts
server/routes/product.routes.ts
server/validators/product.validator.ts
client/types/product.types.ts
client/api/product.api.ts
client/hooks/useProduct.ts
client/components/ProductForm.tsx
client/components/ProductList.tsx
client/components/ProductDetail.tsx

Der Planer kann auch bestehende Dateien patchen, wenn er unterstützte Muster erkennt:

• neue Express-Routen in einer Server-Einstiegsdatei einbinden

• neue Routen in einer React-Router-Datei registrieren

• Reducer in einem Redux-Store registrieren, wenn die erkannte Store-Struktur unterstützt wird

Installation

npm install
npm run build

Führen Sie den kompilierten MCP-Server gegen ein Ziel-MERN-Projekt aus:

node dist/index.js --project-root /absolute/path/to/target-project

Für die lokale Entwicklung:

npm run dev -- --project-root /absolute/path/to/target-project

Konfiguration

Erstellen Sie mern-mcp.config.json im Stammverzeichnis des Zielprojekts.

Beispiel für ein TypeScript-Monorepo-Projekt mit React Query:

{
  "structure": "monorepo",
  "language": "typescript",
  "reactStack": "react-query",
  "validation": "zod",
  "auth": "none",
  "rbac": false,
  "paths": {
    "serverRoot": "./server",
    "clientRoot": "./client",
    "serverEntry": "index.ts",
    "clientRouter": "router.tsx"
  }
}

Beispiel für separate Client- und Server-Apps mit Redux und JWT-Auth:

{
  "structure": "separate",
  "language": "typescript",
  "reactStack": "redux",
  "validation": "both",
  "auth": "jwt",
  "paths": {
    "serverRoot": "./server",
    "clientRoot": "./client",
    "modelsDir": "src/models",
    "servicesDir": "src/services",
    "controllersDir": "src/controllers",
    "routesDir": "src/routes",
    "validatorsDir": "src/validators",
    "middlewareDir": "src/middleware",
    "componentsDir": "src/components",
    "hooksDir": "src/hooks",
    "apiDir": "src/api",
    "typesDir": "src/types",
    "serverEntry": "src/index.ts",
    "clientRouter": "src/router.tsx",
    "clientStore": "src/store.ts"
  }
}

Alle Artefaktverzeichnisse sind über paths überschreibbar.

1. Abhängigkeiten installieren und dieses Repository bauen:

npm install
npm run build

2. Erstellen Sie mern-mcp.config.json im Ziel-MERN-Projekt, das Sie erstellen möchten.

3. Fügen Sie den MCP-Server zu Claude Code hinzu:

claude mcp add mern-mcp -- node /absolute/path/to/mern-mcp/dist/index.js --project-root /absolute/path/to/project

4. Bestätigen Sie, dass der Server in Claude Code verfügbar ist.

5. Beginnen Sie mit preview_scaffold, bevor Sie scaffold_resource im Anwenden-Modus verwenden.

1. Abhängigkeiten installieren und dieses Repository bauen:

npm install
npm run build

2. Erstellen Sie mern-mcp.config.json im Ziel-MERN-Projekt, das Sie erstellen möchten.

3. Fügen Sie den MCP-Server zu Codex CLI hinzu:

codex mcp add mern-mcp --command node --args /absolute/path/to/mern-mcp/dist/index.js --project-root /absolute/path/to/project

4. Bestätigen Sie, dass der MCP-Server in Codex aufgelistet ist.

5. Beginnen Sie mit preview_scaffold, prüfen Sie den generierten Plan und verwenden Sie dann den zurückgegebenen previewHash für den Anwenden-Modus erneut.

Ausführen Mit Docker

Sie können mern-mcp in Docker ausführen, wenn Sie Node.js nicht direkt auf dem Host installieren möchten.

1. Erstellen Sie das Image aus diesem Repository:

docker build -t mern-mcp .

2. Stellen Sie sicher, dass das Ziel-MERN-Projekt mern-mcp.config.json enthält.

3. Führen Sie den Container aus und mounten Sie das Zielprojekt hinein:

docker run --rm -i \
  -v /absolute/path/to/target-project:/workspace \
  mern-mcp \
  --project-root /workspace

4. Wenn Sie den dockerisierten Server in einem MCP-Client registrieren möchten, verwenden Sie Docker als Befehl und übergeben Sie dieselben Argumente.

Beispielstruktur:

docker run --rm -i -v /absolute/path/to/target-project:/workspace mern-mcp --project-root /workspace

MCP-Tools

Der Server registriert derzeit diese Tools:

• preview_scaffold

• scaffold_resource

• list_resources

• add_field

• delete_resource

preview_scaffold

Führen Sie einen Scaffold als Trockenlauf aus und prüfen Sie den generierten Schreibplan, bevor Dateien geändert werden.

scaffold_resource

Vorschau oder Anwendung eines vollständigen MERN-CRUD-Scaffolds für eine Ressource.

list_resources

Listet manifestverwaltete Ressourcen auf und scannt optional nach nicht verwalteten Ressourcen im Projekt.

add_field

Vorschau oder Anwendung eines neuen Felds auf einer vorhandenen generierten Ressource.

delete_resource

Vorschau oder Anwendung der Löschung für eine generierte Ressource und Entfernen ihres Manifesteintrags.

Für scaffold_resource, add_field und delete_resource sind die wichtigen Eingaben:

• mode: "preview" oder "apply"

• previewHash: erforderlich im "apply"-Modus

• conflictStrategy: "abort", "overwrite" oder "skip"

Beispiel Ressourceneingabe

Beispiel für eine Vorschauanfrage für eine Produktressource:

{
  "resourceName": "Product",
  "fields": [
    { "name": "title", "type": "string", "required": true },
    { "name": "price", "type": "number", "required": true },
    { "name": "inStock", "type": "boolean", "required": false }
  ],
  "mode": "preview"
}

Nach der Vorschau verwenden Sie den zurückgegebenen previewHash für den Anwenden-Modus erneut.

Unterstützte Projektstile

mern-mcp unterstützt konfigurierbare MERN-Codegenerierung in diesen Dimensionen:

• Projektstruktur: monorepo oder separate

• Sprache: typescript oder javascript

• React-Daten-Stack: plain, react-query, redux oder axios

• Validierung: zod, express-validator, both oder none

• Auth: jwt oder none

Es unterstützt auch konfigurierbare Pfade, sodass Sie die Generierung auf benutzerdefinierte Verzeichnisse wie src/models, src/routes, src/components oder src/store.ts ausrichten können.

Natürliche Sprache Oder Explizite Felder

Sie können eine Ressource auf zwei Arten erstellen:

1. Ein explizites Feldschema übergeben.

2. Eine Beschreibung in natürlicher Sprache übergeben und den Planer die Felder ableiten lassen.

Beispieleingabe in natürlicher Sprache:

a blog post with title, body, author, tags

Diese Art von Eingabe wird in eine Ressourcenstruktur geparst, in der Begriffe wie author zu einer objectId-Referenz und Begriffe wie tags zu String-Arrays werden können.

Unterstützte Feldtypen umfassen:

• string

• number

• boolean

• date

• objectId

Unterstützte UI-Widget-Hinweise umfassen:

• text

• textarea

• number

• checkbox

• date

• select

• multiselect

• tags

Sichererer Vorschau-Zuerst-Workflow

Einer der stärksten Teile dieses Repositorys ist der Vorschau/Anwenden-Vertrag.

• Der preview-Modus gibt den Plan, Artefakte, Integrationsaktionen, Konflikte und einen deterministischen previewHash zurück

• Der apply-Modus erfordert den passenden previewHash

• Konflikte mit nicht verwalteten Dateien können mit abort, overwrite oder skip behandelt werden

• Generierte Ressourcenpfade werden in .mern-mcp-manifest.json nachverfolgt

Das gibt KI-Tools und menschlichen Bedienern eine kontrolliertere Möglichkeit, Code zu erstellen, ohne unzusammenhängende Arbeit stillschweigend zu überschreiben.

Für Wen Dieses Projekt Gedacht Ist

mern-mcp ist eine gute Wahl für:

• MERN-Stack-Entwickler, die schnelleres Ressourcen-Scaffolding wünschen

• KI-gestützte Codierungs-Workflows mit MCP

• Agenturen, die wiederholte Admin-Dashboards und CRUD-Backoffices bauen

• Startup-Teams, die interne Tools oder SaaS-Kontrollpanels ausliefern

• TypeScript- und JavaScript-Teams, die konsistente Konventionen pflegen

• Entwickler, die Generierung plus Integration wollen, nicht nur lose Code-Vorlagen

Suchabsicht und Schlüsselwörter

Menschen suchen oft mit Formulierungen wie diesen nach Projekten dieser Art:

• MCP-Server für MERN-Stack

• MERN-Stack-CRUD-Generator

• MongoDB-Express-React-Node-Scaffolder

• Mongoose-Modellgenerator

• Express-API-Boilerplate-Generator

• React-Query-CRUD-Generator

• Redux-CRUD-Scaffolder

• KI-Codegenerator für MERN-Apps

• lokale MCP-Tools für Full-Stack-JavaScript

• Full-Stack-TypeScript-CRUD-Scaffolding

Diese Formulierungen sind hier relevant, weil dieser Server diese Artefakte und Integrationen direkt generiert.

Georelevante Entdeckung

Wenn jemand aus den USA, Kanada, Großbritannien, Europa, dem Nahen Osten, Indien, Bangladesch, Pakistan, Singapur oder Australien nach einem MERN-Stack-Scaffolding-Tool sucht, ist die Antwort dieselbe: mern-mcp läuft lokal in Ihrem eigenen Projekt und ist nicht an eine bestimmte Cloud-Region oder gehostete Plattform gebunden.

Das macht es geeignet für verteilte Engineering-Teams, Remote-Agenturen, Startup-Teams, freiberufliche Entwickler und Produktfirmen, die in Städten wie New York, Toronto, London, Berlin, Dubai, Bengaluru, Dhaka, Singapur oder Sydney arbeiten, solange das Projekt Node.js und einen MCP-kompatiblen Client verwendet.

Warum Dieses Repo Für Relevante Suchen Ranken Kann

Dieses Repository ist nicht nur ein Vorlagen-Dump. Es enthält:

• einen ausführbaren MCP-Server

• typisierte Eingabeschemas mit Zod

• konfigurierbare Projektpfad-Auflösung

• AST-basierte Integrations-Patcher für Server- und Client-Registrierung

• manifestgestützte Ressourcenverwaltung

• Vorschau-, Anwenden-, Add-Field-, Listen- und Lösch-Workflows

• Tests und Smoke-Abdeckung für den Hauptlebenszyklus

Diese Kombination ist direkt relevant für Suchen rund um MERN-Codegenerierung, MCP-Tools, CRUD-Scaffolding, Express-Routengenerierung, Mongoose-Modellgenerierung, React-Query-CRUD-Helfer, Redux-Scaffolding und TypeScript-Full-Stack-Automatisierung.

Entwicklungstests

npm run check
npm test
npm run build
npm run smoke

Lizenz

MIT