Production Build

Build a compact Node artifact and run it behind a process manager / reverse proxy.

Looking to deploy to serverless platforms like Vercel, AWS Lambda, or Cloudflare Workers? See the Serverless Deployment guide.

Build

npm run build

yarn build

pnpm build

This compiles TypeScript to dist/ using your project’s tsconfig.json (the CLI passes --project tsconfig.json when present, otherwise falls back to inline tsc flags).

Start

frontmcp create and frontmcp init don’t add a start script by default — run the compiled bundle directly. The default node target emits a CommonJS single-file bundle at dist/{name}.bundle.js (where {name} is your package.json name):

NODE_ENV=production PORT=8080 node dist/my-server.bundle.js

If you prefer a script, add one to package.json:

{
  "scripts": {
    "start": "node dist/my-server.bundle.js"
  }
}

Recommended runtime setup

Use a process manager (PM2, systemd) for restarts and logs.
Put a reverse proxy (NGINX, Traefik, Caddy) in front for TLS and path routing.
Pin matching versions of all @frontmcp/* packages.

Example NGINX snippet

server {
  listen 443 ssl;
  server_name mcp.example.com;

  location /mcp/ {
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto https;
    proxy_pass http://127.0.0.1:8080/mcp/;
  }
}

Troubleshooting

Version mismatch at boot → align all @frontmcp/* versions and reinstall.
No decorators working → ensure experimentalDecorators + emitDecoratorMetadata and import 'reflect-metadata' at the top of main.ts.
Port conflicts → set http.port in @FrontMcp or use PORT env.

Get Started

Concepts

Build

Deploy

Plugins

Adapters

Extensibility

Testing

React SDK

Guides

Build

Start

Recommended runtime setup

Example NGINX snippet

Troubleshooting

​Build

​Start

​Recommended runtime setup

​Example NGINX snippet

​Troubleshooting

Build

Start

Recommended runtime setup

Example NGINX snippet

Troubleshooting