@mostajs/orm-mcp

MCP server for @mostajs/orm — lets AI dev tools (Claude, Cursor, Cline…) generate EntitySchemas, lint them (24 rules), and produce SQL migrations directly from a prompt.

Tools

| Tool | What it does | |---|---| | mostajs_generate_schema | Build a typed EntitySchema (TS) from an entity name + fields (+ relations). Runs the validator on the result. | | mostajs_validate | Lint one or more EntitySchemas with the built-in conceptual validator (24 rules). | | mostajs_create_migration | Diff two schema sets → SQL migration (diffSchemas + generateMigrationSQL). |

All three reuse @mostajs/orm's public API — no logic is reinvented.

Use it (hosted)

A public instance runs at https://orm-mcp.amia.fr/mcp (Streamable HTTP). Add it to your MCP client:

{
  "mcpServers": {
    "mostajs-orm": { "url": "https://orm-mcp.amia.fr/mcp" }
  }
}

Clients that only speak stdio can bridge it:

npx mcp-remote https://orm-mcp.amia.fr/mcp

Visiting https://orm-mcp.amia.fr/mcp in a browser returns a JSON-RPC 405 — that is expected (MCP is POST-only). The human-readable info page is the root /.

Run it (local, stdio)

npx @mostajs/orm-mcp        # stdio transport — the AI tool spawns this process

Local MCP config (Claude Desktop / Cursor / Cline):

{
  "mcpServers": {
    "mostajs-orm": { "command": "npx", "args": ["-y", "@mostajs/orm-mcp"] }
  }
}

In stdio mode, mostajs_validate also accepts a sourceRoot to enable cross-file rules (it reads the local filesystem — disabled on the hosted server for safety).

Run it (self-hosted HTTP)

PORT=14510 npx @mostajs/orm-mcp        # or: npx @mostajs/orm-mcp --http

Serves the MCP endpoint at /mcp (POST) and a health/info page at /.

License

AGPL-3.0-or-later — © Dr Hamid MADANI. Commercial licensing for @mostajs/orm: [email protected].