mern-mcp

AIを活用したMERNスタックCRUDスキャフォルダーおよびMCPサーバー

mern-mcp は、既存のコードベース内でMERNスタックのCRUDリソース一式をスキャフォールドするためのオープンソースのModel Context Protocol (MCP) サーバーであり、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

このリポジトリが役立つ理由

チームが通常必要としているのは、また別の汎用コードジェネレーターではありません。プロジェクトを検査し、既存のフォルダ構造に従い、再利用可能なCRUDスライスを作成し、盲目的な書き込みを避けられるローカルMCPツールです。mern-mcp は、その実用的なワークフローに焦点を当てています。

すでにNext.js、Node.js、MongoDB用のMCPを持っている場合でも、それらのツールは通常、フレームワークまたはデータベースレベルで役立ちます。mern-mcp が役立つのは、モデル、サービス、コントローラー、ルート、バリデーター、クライアントAPI、フック、フォーム、一覧ビュー、詳細ビュー、統合パッチというリソースワークフロー全体を1か所で処理するからです。アシスタントに各レイヤーを個別に配線するよう依頼する代わりに、開発者はCRUDスライス全体を1回でスキャフォールドし、計画を確認して、より速くビジネスロジックに進むことができます。これにより、反復的なセットアップ作業が削減され、統合ステップの見落としが減り、日々のフルスタック開発の退屈さが大幅に軽減されます。

特に次のような場合に役立ちます：

• リソーススキーマからMERN CRUD APIとReact UIをスキャフォールドする

• Mongooseモデル、Expressコントローラー、サービス、ルート、バリデーターを生成する

• Reactフォーム、一覧ビュー、詳細ビュー、フック、共有型、APIモジュールを生成する

• MCP互換のコーディングアシスタントに自分のリポジトリ内でリソースを作成させる

• 適用前にファイル変更をプレビューする

• フィールド追加と削除のワークフローで生成済みリソースを長期的に管理する

• モノレポまたはサーバーとクライアントが分離したプロジェクトをサポートする

mern-mcp が生成するもの

リソースごとに、mern-mcp は以下を生成できます：

• サーバーモデルファイル

• サーバーサービスファイル

• サーバーコントローラーファイル

• サーバールートファイル

• バリデーションが有効な場合のサーバーバリデーターファイル

• JWT認証が有効な場合の認証ミドルウェアファイル

• クライアント共有型ファイル

• クライアントAPIモジュール

• クライアントデータフック

• クライアントフォームコンポーネント

• クライアント一覧コンポーネント

• クライアント詳細コンポーネント

生成される典型的なパスは次のようになります：

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ファイルに新しいルートを登録する

• 検出されたストア構造がサポートされている場合、Reduxストアにレデューサーを登録する

インストール

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 を作成します。

React Queryを使用するモノレポ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. CodexにMCPサーバーが一覧表示されていることを確認します。

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. Docker化されたサーバーを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"
}

プレビュー後、返された 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 などのカスタムディレクトリに生成先を指定できます。

自然言語または明示的なフィールド

リソースのスキャフォールドには2つの方法があります：

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

より安全なプレビュー優先ワークフロー

このリポジトリの最も強力な部分の1つは、プレビュー/適用の契約です。

• 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