@agentailor/create-mcp-server 0.3.0 → 0.4.0

package/README.md

@@ -15,6 +15,7 @@ npx @agentailor/create-mcp-server
 - **Optional OAuth** — OIDC-compliant authentication (SDK only) ([setup guide](docs/oauth-setup.md))
 - **Package manager choice** — npm, pnpm, or yarn
 - **TypeScript ready** — ready to customize
+- **Docker ready** — production Dockerfile included
 - **MCP Inspector** — built-in debugging with `npm run inspect`
 
 ## Frameworks
@@ -67,6 +68,7 @@ my-mcp-server/
 │   ├── server.ts     # MCP server (tools, prompts, resources)
 │   ├── index.ts      # Express app and transport setup
 │   └── auth.ts       # OAuth middleware (if enabled)
+├── Dockerfile        # Production-ready Docker build
 ├── package.json
 ├── tsconfig.json
 ├── .gitignore

package/dist/index.js

@@ -10,6 +10,7 @@ import { getEnvExampleTemplate } from './templates/common/env.example.js';
 import { getServerTemplate as getSdkStatelessServerTemplate, getIndexTemplate as getSdkStatelessIndexTemplate, getReadmeTemplate as getSdkStatelessReadmeTemplate, } from './templates/sdk/stateless/index.js';
 import { getServerTemplate as getSdkStatefulServerTemplate, getIndexTemplate as getSdkStatefulIndexTemplate, getReadmeTemplate as getSdkStatefulReadmeTemplate, getAuthTemplate as getSdkAuthTemplate, } from './templates/sdk/stateful/index.js';
 import { getServerTemplate as getFastMCPServerTemplate, getIndexTemplate as getFastMCPIndexTemplate, getReadmeTemplate as getFastMCPReadmeTemplate, } from './templates/fastmcp/index.js';
+import { getDockerfileTemplate, getDockerignoreTemplate } from './templates/deployment/index.js';
 const sdkTemplateFunctions = {
     stateless: {
         getServerTemplate: getSdkStatelessServerTemplate,
@@ -153,6 +154,8 @@ async function main() {
         }
         // Common files for all templates
         filesToWrite.push(writeFile(join(projectPath, 'package.json'), getPackageJsonTemplate(projectName, templateOptions)), writeFile(join(projectPath, 'tsconfig.json'), getTsconfigTemplate()), writeFile(join(projectPath, '.gitignore'), getGitignoreTemplate()), writeFile(join(projectPath, '.env.example'), getEnvExampleTemplate(templateOptions)));
+        // Deployment files for all templates
+        filesToWrite.push(writeFile(join(projectPath, 'Dockerfile'), getDockerfileTemplate(templateOptions)), writeFile(join(projectPath, '.dockerignore'), getDockerignoreTemplate()));
         // Write all template files
         await Promise.all(filesToWrite);
         // Initialize git repository if requested

package/dist/templates/deployment/dockerfile.d.ts

@@ -0,0 +1,2 @@
+import type { BaseTemplateOptions } from '../common/types.js';
+export declare function getDockerfileTemplate(options?: BaseTemplateOptions): string;

package/dist/templates/deployment/dockerfile.js

@@ -0,0 +1,64 @@
+const packageManagerConfigs = {
+    npm: {
+        lockFile: 'package-lock.json',
+        install: 'npm ci',
+        installProd: 'npm ci --omit=dev',
+        build: 'npm run build',
+    },
+    pnpm: {
+        lockFile: 'pnpm-lock.yaml',
+        install: 'pnpm install --frozen-lockfile',
+        installProd: 'pnpm install --frozen-lockfile --prod',
+        build: 'pnpm run build',
+        setup: 'RUN corepack enable && corepack prepare pnpm@latest --activate',
+    },
+    yarn: {
+        lockFile: 'yarn.lock',
+        install: 'yarn install --frozen-lockfile',
+        installProd: 'yarn install --frozen-lockfile --production',
+        build: 'yarn build',
+        setup: 'RUN corepack enable',
+    },
+};
+export function getDockerfileTemplate(options) {
+    const packageManager = options?.packageManager ?? 'npm';
+    const config = packageManagerConfigs[packageManager];
+    const setupStep = config.setup ? `\n${config.setup}\n` : '';
+    return `# Multi-stage build for production
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+${setupStep}
+# Copy package files
+COPY package.json ${config.lockFile} ./
+
+# Install all dependencies (including dev)
+RUN ${config.install}
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN ${config.build}
+
+# Production stage
+FROM node:20-alpine AS production
+
+WORKDIR /app
+${setupStep}
+# Copy package files
+COPY package.json ${config.lockFile} ./
+
+# Install production dependencies only
+RUN ${config.installProd}
+
+# Copy built application from builder stage
+COPY --from=builder /app/dist ./dist
+
+# Expose the port the app runs on
+EXPOSE 3000
+
+# Start the application
+CMD ["node", "dist/index.js"]
+`;
+}

package/dist/templates/deployment/dockerignore.d.ts

@@ -0,0 +1 @@
+export declare function getDockerignoreTemplate(): string;

package/dist/templates/deployment/dockerignore.js

@@ -0,0 +1,37 @@
+export function getDockerignoreTemplate() {
+    return `# Dependencies
+node_modules/
+
+# Build output (rebuilt in container)
+dist/
+
+# Git
+.git/
+.gitignore
+
+# Environment files (should be set in container)
+.env
+.env.*
+
+# Documentation
+*.md
+
+# IDE
+.vscode/
+.idea/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Test files
+*.test.ts
+*.spec.ts
+__tests__/
+coverage/
+`;
+}

package/dist/templates/deployment/index.d.ts

@@ -0,0 +1,2 @@
+export { getDockerfileTemplate } from './dockerfile.js';
+export { getDockerignoreTemplate } from './dockerignore.js';

package/dist/templates/deployment/index.js

@@ -0,0 +1,2 @@
+export { getDockerfileTemplate } from './dockerfile.js';
+export { getDockerignoreTemplate } from './dockerignore.js';

package/dist/templates/deployment/templates.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/deployment/templates.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect } from 'vitest';
+import { getDockerfileTemplate } from './dockerfile.js';
+import { getDockerignoreTemplate } from './dockerignore.js';
+describe('deployment templates', () => {
+    describe('getDockerfileTemplate', () => {
+        it('should use multi-stage build', () => {
+            const template = getDockerfileTemplate();
+            expect(template).toContain('AS builder');
+            expect(template).toContain('AS production');
+        });
+        it('should use Node 20 Alpine', () => {
+            const template = getDockerfileTemplate();
+            expect(template).toContain('FROM node:20-alpine');
+        });
+        it('should copy dist folder from builder', () => {
+            const template = getDockerfileTemplate();
+            expect(template).toContain('COPY --from=builder /app/dist ./dist');
+        });
+        it('should expose port 3000', () => {
+            const template = getDockerfileTemplate();
+            expect(template).toContain('EXPOSE 3000');
+        });
+        it('should run node dist/index.js', () => {
+            const template = getDockerfileTemplate();
+            expect(template).toContain('CMD ["node", "dist/index.js"]');
+        });
+        describe('npm (default)', () => {
+            it('should use npm ci for install', () => {
+                const template = getDockerfileTemplate();
+                expect(template).toContain('RUN npm ci');
+            });
+            it('should use npm ci --omit=dev for production', () => {
+                const template = getDockerfileTemplate();
+                expect(template).toContain('npm ci --omit=dev');
+            });
+            it('should copy package-lock.json', () => {
+                const template = getDockerfileTemplate();
+                expect(template).toContain('COPY package.json package-lock.json');
+            });
+            it('should use npm run build', () => {
+                const template = getDockerfileTemplate();
+                expect(template).toContain('RUN npm run build');
+            });
+        });
+        describe('pnpm', () => {
+            it('should use pnpm install --frozen-lockfile', () => {
+                const template = getDockerfileTemplate({ packageManager: 'pnpm' });
+                expect(template).toContain('RUN pnpm install --frozen-lockfile');
+            });
+            it('should use pnpm install --frozen-lockfile --prod for production', () => {
+                const template = getDockerfileTemplate({ packageManager: 'pnpm' });
+                expect(template).toContain('pnpm install --frozen-lockfile --prod');
+            });
+            it('should copy pnpm-lock.yaml', () => {
+                const template = getDockerfileTemplate({ packageManager: 'pnpm' });
+                expect(template).toContain('COPY package.json pnpm-lock.yaml');
+            });
+            it('should enable corepack for pnpm', () => {
+                const template = getDockerfileTemplate({ packageManager: 'pnpm' });
+                expect(template).toContain('corepack enable');
+                expect(template).toContain('corepack prepare pnpm');
+            });
+            it('should use pnpm run build', () => {
+                const template = getDockerfileTemplate({ packageManager: 'pnpm' });
+                expect(template).toContain('RUN pnpm run build');
+            });
+        });
+        describe('yarn', () => {
+            it('should use yarn install --frozen-lockfile', () => {
+                const template = getDockerfileTemplate({ packageManager: 'yarn' });
+                expect(template).toContain('RUN yarn install --frozen-lockfile');
+            });
+            it('should use yarn install --frozen-lockfile --production for production', () => {
+                const template = getDockerfileTemplate({ packageManager: 'yarn' });
+                expect(template).toContain('yarn install --frozen-lockfile --production');
+            });
+            it('should copy yarn.lock', () => {
+                const template = getDockerfileTemplate({ packageManager: 'yarn' });
+                expect(template).toContain('COPY package.json yarn.lock');
+            });
+            it('should enable corepack for yarn', () => {
+                const template = getDockerfileTemplate({ packageManager: 'yarn' });
+                expect(template).toContain('corepack enable');
+            });
+            it('should use yarn build', () => {
+                const template = getDockerfileTemplate({ packageManager: 'yarn' });
+                expect(template).toContain('RUN yarn build');
+            });
+        });
+    });
+    describe('getDockerignoreTemplate', () => {
+        it('should ignore node_modules', () => {
+            const template = getDockerignoreTemplate();
+            expect(template).toContain('node_modules/');
+        });
+        it('should ignore dist folder', () => {
+            const template = getDockerignoreTemplate();
+            expect(template).toContain('dist/');
+        });
+        it('should ignore .env files', () => {
+            const template = getDockerignoreTemplate();
+            expect(template).toContain('.env');
+        });
+        it('should ignore .git folder', () => {
+            const template = getDockerignoreTemplate();
+            expect(template).toContain('.git/');
+        });
+    });
+});

package/dist/templates/fastmcp/readme.js

@@ -34,9 +34,10 @@ ${cmd.start}
 
 The server will start on port 3000 by default. You can change this by setting the \`PORT\` environment variable.
 
-## API Endpoint
+## API Endpoints
 
 - **POST /mcp** - Main MCP endpoint for JSON-RPC messages
+- **GET /health** - Health check endpoint (returns 200 OK)
 
 ## Included Examples
 
@@ -63,11 +64,22 @@ ${projectName}/
 ├── src/
 │   ├── server.ts     # FastMCP server definition (tools, prompts, resources)
 │   └── index.ts      # Server startup configuration
+├── Dockerfile        # Multi-stage Docker build
 ├── package.json
 ├── tsconfig.json
 └── README.md
 \`\`\`
 
+## Deployment
+
+### Docker
+
+Build and run the Docker container:
+
+\`\`\`bash
+docker build -t ${projectName} .
+docker run -p 3000:3000 ${projectName}
+\`\`\`
 ## Customization
 
 - Add new tools, prompts, and resources in \`src/server.ts\`

package/dist/templates/sdk/stateful/index.js

@@ -19,7 +19,10 @@ import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
 import { getServer } from './server.js';`;
-    const appSetup = `const app = createMcpExpressApp();`;
+    const appSetup = `const app = createMcpExpressApp();
+
+// Health check endpoint for container orchestration
+app.get('/health', (_, res) => res.sendStatus(200));`;
     const postRoute = withOAuth
         ? `app.post('/mcp', authMiddleware, async (req: Request, res: Response) => {`
         : `app.post('/mcp', async (req: Request, res: Response) => {`;

package/dist/templates/sdk/stateful/readme.js

@@ -63,6 +63,7 @@ ${projectName}/
 │   ├── server.ts     # MCP server definition (tools, prompts, resources)
 │   ├── index.ts      # Express app and stateful HTTP transport setup
 │   └── auth.ts       # OAuth configuration and middleware
+├── Dockerfile        # Multi-stage Docker build
 ├── package.json
 ├── tsconfig.json
 └── README.md
@@ -72,10 +73,23 @@ ${projectName}/
 ├── src/
 │   ├── server.ts     # MCP server definition (tools, prompts, resources)
 │   └── index.ts      # Express app and stateful HTTP transport setup
+├── Dockerfile        # Multi-stage Docker build
 ├── package.json
 ├── tsconfig.json
 └── README.md
 \`\`\``;
+    const deploymentSection = `
+## Deployment
+
+### Docker
+
+Build and run the Docker container:
+
+\`\`\`bash
+docker build -t ${projectName} .
+docker run -p 3000:3000 ${projectName}
+\`\`\`
+`;
     const customizationOAuthNote = withOAuth
         ? '\n- Configure OAuth scopes and token verification in `src/auth.ts`'
         : '';
@@ -112,6 +126,7 @@ ${oauthSection}
   - Requires \`mcp-session-id\` header${apiEndpointsOAuthNote}
 - **DELETE /mcp** - Terminate a session
   - Requires \`mcp-session-id\` header${apiEndpointsOAuthNote}
+- **GET /health** - Health check endpoint (returns 200 OK)
 
 ## Session Management
 
@@ -144,6 +159,7 @@ This server comes with example implementations to help you get started:
 ## Project Structure
 
 ${projectStructure}
+${deploymentSection}
 
 ## Customization
 

package/dist/templates/sdk/stateless/index.js

@@ -8,6 +8,9 @@ import { getServer } from './server.js';
 
 const app = createMcpExpressApp();
 
+// Health check endpoint for container orchestration
+app.get('/health', (_, res) => res.sendStatus(200));
+
 app.post('/mcp', async (req: Request, res: Response) => {
   const server = getServer();
   try {

package/dist/templates/sdk/stateless/readme.js

@@ -29,9 +29,10 @@ ${commands.start}
 
 The server will start on port 3000 by default. You can change this by setting the \`PORT\` environment variable.
 
-## API Endpoint
+## API Endpoints
 
 - **POST /mcp** - Main MCP endpoint for JSON-RPC messages
+- **GET /health** - Health check endpoint (returns 200 OK)
 
 ## Included Examples
 
@@ -58,11 +59,23 @@ ${projectName}/
 ├── src/
 │   ├── server.ts     # MCP server definition (tools, prompts, resources)
 │   └── index.ts      # Express app and HTTP transport setup
+├── Dockerfile        # Multi-stage Docker build
 ├── package.json
 ├── tsconfig.json
 └── README.md
 \`\`\`
 
+## Deployment
+
+### Docker
+
+Build and run the Docker container:
+
+\`\`\`bash
+docker build -t ${projectName} .
+docker run -p 3000:3000 ${projectName}
+\`\`\`
+
 ## Customization
 
 - Add new tools, prompts, and resources in \`src/server.ts\`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentailor/create-mcp-server",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Create a new MCP (Model Context Protocol) server project",
   "type": "module",
   "bin": {