Skip to main content
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"
  }
}
  • 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.