mern-mcp

AI-конструктор CRUD-заготовок для MERN-стека и MCP-сервер

mern-mcp — это MCP-сервер с открытым исходным кодом для создания CRUD-ресурсов полного MERN-стека в существующей кодовой базе, с прямой поддержкой настройки как для Claude Code, так и для Codex CLI. Он генерирует модели MongoDB и Mongoose, маршруты и контроллеры Express, клиентские модули React и всю обвязку для подключения нового ресурса в реальное приложение с более безопасным рабочим процессом «сначала предпросмотр, потом применение».

Если вы ищете MCP-сервер для разработки на MERN-стеке, генератор CRUD для MongoDB Express React Node, генератор моделей Mongoose и маршрутов Express, конструктор React-админки для работы с AI-ассистентами кодирования, этот репозиторий создан именно для этого.

Оглавление: Зачем полезен этот репозиторий · Что генерирует mern-mcp · Установка · Конфигурация · Claude Code · Codex CLI · Docker · MCP Tools · Пример · Стили проектов · Естественный язык · Безопасный предпросмотр · Для кого этот проект

Related MCP server: MCP Terminal & Git Server

Зачем этот репозиторий полезен

Командам обычно не нужен ещё один типовой генератор кода. Им нужен локальный MCP-инструмент, который может проверить проект, следовать существующей структуре папок, создавать повторяемые CRUD-срезы и избегать слепых записей. mern-mcp сосредоточен на этом практическом рабочем процессе.

Даже если у вас уже есть MCP-клиенты для Next.js, Node.js или MongoDB, эти инструменты обычно помогают на уровне фреймворка или базы данных. mern-mcp полезен тем, что обрабатывает весь путь создания ресурса в одном месте: модель, сервис, контроллер, маршруты, валидаторы, клиентский API, хуки, формы, представления списков, представления деталей и патчи интеграции. Вместо того чтобы просить ассистента соединять каждый слой отдельно, разработчик может создать весь CRUD-срез за один проход, изучить план и перейти к бизнес-логике быстрее. Это сокращает повторяющуюся работу, уменьшает количество пропущенных шагов интеграции и делает повседневную full-stack разработку заметно менее утомительной.

Это особенно полезно, когда нужно:

• создать CRUD API и React UI ресурса из схемы

• генерировать схемы Mongoose, контроллеры Express, сервисы, маршруты и валидаторы

• генерировать React-формы, представления списков, представления деталей, хуки, общие типы и API-модули

• позволить MCP-совместимому ассистенту кодирования создавать ресурсы в вашем собственном репозитории

• предпросмотр изменений файлов до их применения

• управлять сгенерированными ресурсами в течение нескольких лет с помощью процессов add-field/delete

• поддерживать монорепозиторий или отдельные проекты сервера и клиента

Что генерирует mern-mcp

Для каждого ресурса mern-mcp активирует:

• server model file (файл серверной модели)

• server service file (файл сервиса?)

• server controller file (файл контроллера)

• server routes file (файл маршрутов)

• server validator file when validating enabled (файл валидатора)

• auth middleware file when JWT auth enabled (файл auth-middleware)

• client shared types file (файл общих типов)

• client API module (API-модуль клиента)

• client data hook (клиентский хук данных)

• client form component (клиентский компонент формы)

• client list component (клиентский компонент списка)

• client detail component (клиентский компонент деталей)

Обычные сгенерированные пути выглядят так:

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

Планировщик умеет пропатчивать существующие файлы, когда обнаруживает поддерживаемые паттерны:

• монтировать новые Express-маршруты в серверный entry-файл

• регистрировать новые маршруты в файле React Router

• регистрировать редьюсеры в store Redux, если поддерживается определённая форма store

Установка

npm install
npm run build

Запустите откомпилированный MCP-сервер против целевого MERN-проекта:

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

Для локальной разработки:

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

Конфигурация

Создайте mern-mcp.config.json в корне целевого проекта.

Пример для монорепозитория TypeScript-проекта с 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"
  }
}

Пример для раздельных приложений клиента и сервера с Redux и JWT-аутентификацией:

{
  "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"
  }
}

Все пути артефактов переопределяются через paths.

1. Установите зависимости и соберите этот репозиторий:

npm install
npm run build

2. Создайте mern-mcp.config.json в целевом MERN-проекте.

3. Добавьте MCP-сервер в Claude Code:

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

4. Убедитесь, что сервер доступен в Claude.

5. Начните с preview_scaffold, прежде чем использовать scaffold_resource в режиме apply.

1. Установите зависимости и соберите этот репозиторий:

npm install
npm run build

2. Создайте mern-mcp.config.json в целевом MERN-проекте.

3. Добавьте MCP-сервер в Codex CLI:

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

4. Убедитесь, что MCP-сервер указан в Codex.

5. Начните с preview_scaffold, проверьте сгенерированный план, затем используйте возвращаемый previewHash для режима apply.

Запуск с Docker

Вы можете запустить mern-mcp в Docker, если не хотите устанавливать Node.js прямо на хост.

1. Соберите образ из этого репозитория:

docker build -t mern-mcp .

2. Убедитесь, что целевой MERN-проект содержит mern-mcp.config.json.

3. Запустите контейнер и смонтируйте целевой проект внутрь:

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

4. Если вы хотите зарегистрировать сервер с Dockerized в MCP-клиенте, используйте Docker как команду и укажите те же аргументы.

Пример формы:

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

MCP-инструменты

Сервер в настоящее время регистрирует такие инструменты:

• preview_scaffold

• scaffold_resource

• list_resources

• add_field

• delete_resource

preview_scaffold (предпросмотр каркаса)

Предварительный просмотр схемы и проверка сгенерированного плана записи перед изменением файлов.

scaffold_resource (каркас ресурса)

Предпросмотр или применение полного MERN CRUD-подмостков для ресурса.

list_resources (список ресурсов)

Перечислить ресурсы, управляемые манифестом, и при желании найти неуправляемые ресурсы в проекте.

add_field (добавить поле)

Предпросмотр или применение нового поля к существующему сгенерированному ресурсу.

delete_resource (удалить ресурс)

Предпросмотр или применение удаления для созданного ресурса и удалить запись из манифеста.

То же самое для scaffold_resource, add_field, и delete_resource важные входы:

• mode: "preview" или "apply"

• previewHash (хэш предпросмотра): требуется в режиме "apply"

• conflictStrategy (стратегия конфликта): "abort", "overwrite" или "skip"

Пример входных данных ресурса

Пример запроса на предпросмотр ресурса product:

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

После предпросмотра используйте возвращённый preview (предпросмотр) и хэш previewHash для режима apply.

Поддерживаемые стили проектов

mern-mcp поддерживает настраиваемую генерацию кода MERN по следующим параметрам:

• структура проекта: monorepo или separate

• язык: typescript или javascript

• стек данных React: plain, react-query, redux или axios

• валидация: zod, express-validator, both или none

• аутентификация: jwt или none

Она также поддерживает настраиваемые пути, поэтому вы можете указать генерацию в пользовательские каталоги, например src/models, src/routes, src/components или src/store.ts.

Естественный язык или явные поля

Вы можете создать ресурс двумя способами:

1. Передать явную схему полей.

2. Передать описание на естественном языке и позволить планировщику вывести поля.

Пример ввода на естественном языке:

a blog post with title, body, author, tags

Такой ввод разбирается в структуру ресурса, где такие термины, как author (автор), могут стать ссылкой objectId, а такие термины, как tags, могут стать массивом строк.

Поддерживаемые типы полей:

• string

• number

• boolean

• date

• objectId

Поддерживаемые виджеты UI:

• text

• textarea

• number

• checkbox

• date

• select

• multiselect

• tags

Безопасный предпочтительный рабочий процесс

Одна из самых сильных сторон этого репозитория — контракт предпросмотра/применения.

• Режим preview возвращает план, его артефакты и конфликты по интеграции, а также детерминированный previewHash.

• Режим apply требует соответствующего previewHash

• Конфликты с неуправляемыми файлами можно обрабатывать через abort, overwrite или skip

• пути сгенерированных ресурсов отслеживаются в .mern-mcp-manifest.json

Это даёт ИИ-инструментам и разработчикам более контролируемый способ строить код без беззвучной перезаписи чужих наработок.

Для кого этот проект

mern-mcp — хороший выбор для:

• разработчиков MERNMRN-стека, желающих ускорить создание ресурсов

• AI-ассистируемых кодинговых процессов, работающих через MCP

• агентств, строящих повторяющиеся админ-панели и внутренние CRUD-системы

• стартапов, выпускающих внутренние инструменты или SaaS-консоли управления

• TypeScript- и JavaScript-команд, сохраняющих единые стандарты

• разработчиков, которые хотят генерацию и интеграцию, а не просто сырые шаблоны

Поисковые запросы и намерения

Люди часто ищут проекты такого типа по фразам вроде:

• MCP-сервер для MERN-стека

• MERN CRUD-генератор

• MongoDB Express React Node-генератор каркасов

• генератор моделей Mongoose

• Express API-генератор шаблонов

• React Query CRUD-генератор

• Redux CRUD-каркас

• ИИ-генератор кода для приложений MERN

• локальный MCP-инструмент для full-stack JavaScript

• TypeScript-каркас CRUD

Эти запросы уместны, потому что сервер напрямую генерирует эти артефакты и интеграции.

Гео-релевантные сведения

Если кто-то ищет инструмент каркаса MERN-стека из США, Канады, Европы, Великобритании, Ближнего Востока, Индии, Бангладеша, Пакистана, Сингапура или Австралии, ответ всё равно один: mern-mcp работает локально в вашем проекте и не привязан к конкретному региону облака или размещённой платформе.

Это подходит для распределённых команд, удалённых агентств, стратап-групп, фрилансеров и продуктовых команд, работающих в таких городах, как Нью-Йорк, Лондон, Берлин, Дубай, Бангалор, Дакка, Сингапур или Сидней, если проект использует Node.js или MCP-совместимый клиент.

Почему этот репозиторий может ранжироваться по релевантным запросам

Этот репозиторий не просто набор шаблонов. В нём есть:

• рабочий MCP-сервер

• типизированные входные схемы через Zod

• настраиваемое разрешение путей проекта

• AST-патчи для регистрации серверов и клиентов

• ресурсы управления манифестами

• процессы предпросмотра, применения, добавления полей, списка и удаления

• тесты и смоук-покрытие основного жизненного цикла

Эта комбинация напрямую релевантна для поисков по генерации кода MERN, инструментам MCP, CRUD-шаблонам, генерации маршрутов Express, генерации моделей Mongoose, CRUD-хелперам React Query, Redux-шаблонам и автоматизации полного цикла TypeScript.

Проверка разработки

npm run check
npm test
npm run build
npm run smoke

Лицензия

MIT