mern-mcp

基于 AI 的 MERN 全栈 CRUD 脚手架生成器与 MCP 服务器

mern-mcp 是一个开源的模型上下文协议（MCP）服务器，用于在现有代码库中搭建完整的 MERN 全栈 CRUD 资源，并直接支持 Claude Code 和 Codex CLI 的配置。它可以生成 MongoDB 和 Mongoose 模型、Express 服务和路由、React 客户端模块，以及将新资源接入真实应用所需的连接代码，并采用更安全的"先预览后应用"工作流。

如果你正在寻找用于 MERN 全栈开发的 MCP 服务器、MongoDB Express React Node.js CRUD 生成器、Mongoose 加 Express 样板代码生成器，或可与 AI 编码助手配合使用的 React 管理后台脚手架工具，本仓库正是为此而构建的。

目录： 为什么有用 · 生成的文件 · 安装 · 配置 · Claude Code · Codex CLI · Docker · MCP 工具 · 示例 · 项目风格 · 自然语言 · 预览工作流 · 适用人群

Related MCP server: MCP Terminal & Git Server

为什么本仓库有用

团队通常并不需要另一个通用代码生成器。他们需要的是一个本地 MCP 工具，能够检查项目、遵循现有目录结构、创建可复用的 CRUD 切片，并避免盲目写入。mern-mcp 正是专注于这种实用工作流。

即使你已经有针对 Next.js、Node.js 或 MongoDB 的 MCP 工具，这些工具通常只在框架或数据库层面提供帮助。mern-mcp 之所以有用，是因为它在一个地方处理完整的资源工作流：模型、服务、控制器、路由、验证器、客户端 API、hooks、表单、列表视图、详情视图以及集成补丁。开发者无需让助手逐层分别接线，而可以一次性搭建整个 CRUD 切片、审查计划，然后更快地进入业务逻辑。这减少了重复的搭建工作，降低了遗漏集成步骤的风险，让日常的全栈开发不再那么繁琐。

当你想要以下功能时，它尤其有用：

• 根据资源模式搭建 MERN CRUD API 和 React UI

• 生成 Mongoose 模型、Express 控制器、服务、路由和验证器

• 生成 React 表单、列表视图、详情视图、hooks、共享类型和 API 模块

• 让兼容 MCP 的编码助手在你自己的仓库中创建资源

• 在应用更改之前预览文件变更

• 通过添加字段和删除工作流长期管理已生成的资源

• 支持 monorepo 或分离的服务器与客户端项目

mern-mcp 生成什么

对于每个资源，mern-mcp 可以生成：

• 服务器模型文件

• 服务器服务文件

• 服务器控制器文件

• 服务器路由文件

• 启用验证时的服务器验证器文件

• 启用 JWT 认证时的认证中间件文件

• 客户端共享类型文件

• 客户端 API 模块

• 客户端数据 hook

• 客户端表单组件

• 客户端列表组件

• 客户端详情组件

典型的生成路径如下所示：

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 路由

• 在 React Router 文件中注册新路由

• 在检测到受支持的 store 结构时在 Redux store 中注册 reducer

安装

npm install
npm run build

针对目标 MERN 项目运行编译后的 MCP 服务器：

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。

使用 React Query 的 monorepo TypeScript 项目示例：

{
  "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 项目中创建 mern-mcp.config.json。

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 Code 中可用。

5. 在应用模式下使用 scaffold_resource 之前，先使用 preview_scaffold。

1. 安装依赖并构建本仓库：

npm install
npm run build

2. 在你要搭建的目标 MERN 项目中创建 mern-mcp.config.json。

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 进行应用模式。

使用 Docker 运行

如果你不想在宿主机上直接安装 Node.js，可以在 Docker 中运行 mern-mcp。

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. 如果你想在 MCP 客户端中注册 Docker 化的服务器，请使用 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"

示例资源输入

产品资源的示例预览请求：

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

预览后，复用返回的 previewHash 进行应用模式。

支持的项目风格

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 中

这为 AI 工具和人工操作员提供了一种更可控的代码搭建方式，而不会静默覆盖无关的工作。

本项目适合谁

mern-mcp 非常适合：

• 希望更快搭建资源的 MERN 全栈开发者

• 使用 MCP 的 AI 辅助编码工作流

• 构建重复管理后台和 CRUD 后台系统的代理机构

• 交付内部工具或 SaaS 控制面板的创业团队

• 维护一致约定的 TypeScript 和 JavaScript 团队

• 需要生成加集成（而不仅仅是零散代码模板）的开发者

搜索意图与关键词

人们通常使用以下短语搜索此类项目：

• MERN 全栈的 MCP 服务器

• MERN 全栈 CRUD 生成器

• MongoDB Express React Node 脚手架工具

• Mongoose 模型生成器

• Express API 样板代码生成器

• React Query CRUD 生成器

• Redux CRUD 脚手架工具

• MERN 应用的 AI 代码生成器

• 全栈 JavaScript 的本地 MCP 工具

• 全栈 TypeScript CRUD 脚手架

这些短语与本项目直接相关，因为该服务器直接生成这些产物和集成。

地理相关发现

如果有人从美国、加拿大、英国、欧洲、中东、印度、孟加拉国、巴基斯坦、新加坡或澳大利亚搜索 MERN 全栈脚手架工具，答案都是一样的：mern-mcp 在你自己的项目中本地运行，不绑定到特定的云区域或托管平台。

这使得它适用于分布式工程团队、远程代理机构、创业团队、自由开发者以及来自纽约、多伦多、伦敦、柏林、迪拜、班加罗尔、达卡、新加坡或悉尼等城市的产品公司，只要项目使用 Node.js 和兼容 MCP 的客户端即可。

为什么本仓库可以在相关搜索中排名靠前

本仓库不仅仅是模板的堆砌。它包含：

• 可运行的 MCP 服务器

• 使用 Zod 的类型化输入模式

• 可配置的项目路径解析

• 基于 AST 的服务器和客户端注册集成补丁器

• 基于清单的资源管理

• 预览、应用、添加字段、列出和删除工作流

• 主要生命周期的测试和冒烟覆盖

这种组合与围绕 MERN 代码生成、MCP 工具、CRUD 脚手架、Express 路由生成、Mongoose 模型生成、React Query CRUD 辅助工具、Redux 脚手架和 TypeScript 全栈自动化的搜索直接相关。

开发检查

npm run check
npm test
npm run build
npm run smoke

许可证

MIT