wip

Author: tomkosm

.github/workflows/image-staging.yml

@@ -33,7 +33,7 @@ jobs:
         uses: docker/build-push-action@v2
         with:
           context: .
-          file: ./Dockerfile
+          file: ./Dockerfile.service
           push: true
           tags: ghcr.io/firecrawl/firecrawl-mcp-server-alpha:latest
           cache-from: type=registry,ref=ghcr.io/firecrawl/firecrawl-mcp-server-alpha:latest

Dockerfile.service

@@ -1,19 +1,34 @@
-FROM node:22-slim
+## Service image: Node (FastMCP) + NGINX sidecar in one container
 
+# 1) Build stage
+FROM node:22-alpine AS builder
 WORKDIR /app
 
-COPY package.json package-lock.json* ./
+COPY package*.json ./
+# Ensure dev dependencies (typescript, etc.) are installed for build
+RUN npm ci --include=dev
 
-
-COPY tsconfig.json ./
-COPY src ./src
+COPY . .
 RUN npm run build
 
-ENV CLOUD_SERVICE=true
-ENV PORT=3000
 
-# Expose the port
-EXPOSE 3000
+# 2) Runtime stage (Node + NGINX)
+FROM node:22-alpine AS runner
+WORKDIR /app
+
+RUN apk add --no-cache nginx bash curl
+
+# Copy built app and install prod deps only
+COPY --from=builder /app/dist ./dist
+COPY package*.json ./
+RUN npm ci --omit=dev --ignore-scripts
+
+# NGINX config and entrypoint
+COPY docker/nginx.conf /etc/nginx/nginx.conf
+COPY docker/entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+ENV PORT=3000
+EXPOSE 8080
 
-# Run the server
-CMD ["node", "dist/index.js"]
+CMD ["/entrypoint.sh"]

docker/entrypoint.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+set -e
+
+# Start Node app in background
+node dist/index.js &
+APP_PID=$!
+
+# Start NGINX in foreground
+nginx -g 'daemon off;'
+
+wait $APP_PID
+
+

docker/nginx.conf

@@ -0,0 +1,101 @@
+events {}
+http {
+  upstream app { server 127.0.0.1:3000; }
+
+  server {
+    listen 8080;
+
+    # Alias common typo/variant: /{apiKey}/v1|v2/see -> /sse
+    location ~ ^/(?<apikey>[^/]+)/v(?:1|2)/see$ {
+      proxy_set_header X-Firecrawl-API-Key $apikey;
+      proxy_set_header Host $host;
+
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+
+      proxy_pass http://app/sse;
+    }
+
+    # Legacy with API key and version: /{apiKey}/v1|v2/{rest}
+    location ~ ^/(?<apikey>[^/]+)/v(?:1|2)/(.*)$ {
+      proxy_set_header X-Firecrawl-API-Key $apikey;
+      proxy_set_header Host $host;
+
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+
+      proxy_pass http://app/$2;
+    }
+
+    # Legacy: /{apiKey}/{rest}
+    location ~ ^/(?<apikey>[^/]+)/(.*)$ {
+      proxy_set_header X-Firecrawl-API-Key $apikey;
+      proxy_set_header Host $host;
+
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+
+      proxy_pass http://app/$2;
+    }
+
+    # Header-based with version alias: /v1|v2/see -> /sse
+    location ~ ^/v(?:1|2)/see$ {
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $remote_addr;
+      proxy_set_header X-Forwarded-Proto $scheme;
+      proxy_pass http://app/sse;
+    }
+
+    # Header-based with version: /v1|v2/{rest}
+    location ~ ^/v(?:1|2)/(.*)$ {
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $remote_addr;
+      proxy_set_header X-Forwarded-Proto $scheme;
+      proxy_pass http://app/$1;
+    }
+
+    # Direct header-based paths
+    location /mcp {
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+      proxy_pass http://app/mcp;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $remote_addr;
+      proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location /messages {
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+      proxy_pass http://app/messages;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $remote_addr;
+      proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location /sse {
+      proxy_buffering off;
+      proxy_read_timeout 620s;
+      proxy_send_timeout 620s;
+      proxy_pass http://app/sse;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $remote_addr;
+      proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location /health { return 200 "ok"; }
+  }
+}
+
+