@agentailor/create-mcp-server 0.2.0 → 0.2.1

package/dist/index.js

@@ -98,7 +98,7 @@ async function main() {
         initial: true,
     }, { onCancel });
     const withGitInit = gitInitResponse.withGitInit ?? false;
-    const templateOptions = { withOAuth };
+    const templateOptions = { withOAuth, packageManager };
     const templates = templateFunctions[templateType];
     const projectPath = join(process.cwd(), projectName);
     const srcPath = join(projectPath, 'src');

package/dist/templates/common/env.example.d.ts

@@ -1,4 +1,5 @@
 export interface TemplateOptions {
     withOAuth?: boolean;
+    packageManager?: 'npm' | 'pnpm' | 'yarn';
 }
 export declare function getEnvExampleTemplate(options?: TemplateOptions): string;

package/dist/templates/common/package.json.d.ts

@@ -1,4 +1,5 @@
 export interface TemplateOptions {
     withOAuth?: boolean;
+    packageManager?: 'npm' | 'pnpm' | 'yarn';
 }
 export declare function getPackageJsonTemplate(projectName: string, options?: TemplateOptions): string;

package/dist/templates/stateful-streamable-http/index.d.ts

@@ -1,5 +1,6 @@
 export interface TemplateOptions {
     withOAuth?: boolean;
+    packageManager?: 'npm' | 'pnpm' | 'yarn';
 }
 export declare function getIndexTemplate(options?: TemplateOptions): string;
 export { getServerTemplate } from './server.js';

package/dist/templates/stateful-streamable-http/index.js

@@ -29,10 +29,6 @@ import { getServer } from './server.js';`;
     const deleteRoute = withOAuth
         ? `app.delete('/mcp', authMiddleware, async (req: Request, res: Response) => {`
         : `app.delete('/mcp', async (req: Request, res: Response) => {`;
-    const startupLog = withOAuth
-        ? `console.log(\`MCP Stateful HTTP Server listening on port \${PORT}\`);
-    console.log(\`OAuth metadata available at \${getOAuthMetadataUrl()}\`);`
-        : `console.log(\`MCP Stateful HTTP Server listening on port \${PORT}\`);`;
     return `${imports}
 
 ${appSetup}
@@ -144,6 +140,24 @@ ${withOAuth
         ? `// Start the server
 const PORT = process.env.PORT || 3000;
 
+function startServer(port: number | string): void {
+  const server = app.listen(port, () => {
+    console.log(\`MCP Stateful HTTP Server listening on port \${port}\`);
+    console.log(\`OAuth metadata available at \${getOAuthMetadataUrl()}\`);
+  });
+
+  server.on('error', (error: NodeJS.ErrnoException) => {
+    if (error.code === 'EADDRINUSE') {
+      const randomPort = Math.floor(Math.random() * (65535 - 49152) + 49152);
+      console.log(\`Port \${port} is in use, trying port \${randomPort}...\`);
+      startServer(randomPort);
+    } else {
+      console.error('Failed to start server:', error);
+      process.exit(1);
+    }
+  });
+}
+
 async function main() {
   // Validate OAuth configuration and fetch OIDC discovery document
   await validateOAuthConfig();
@@ -151,9 +165,7 @@ async function main() {
   // Setup OAuth metadata routes (must be after validateOAuthConfig)
   setupAuthMetadataRouter(app);
 
-  app.listen(PORT, () => {
-    ${startupLog}
-  });
+  startServer(PORT);
 }
 
 main().catch((error) => {
@@ -162,9 +174,25 @@ main().catch((error) => {
 });`
         : `// Start the server
 const PORT = process.env.PORT || 3000;
-app.listen(PORT, () => {
-  ${startupLog}
-});`}
+
+function startServer(port: number | string): void {
+  const server = app.listen(port, () => {
+    console.log(\`MCP Stateful HTTP Server listening on port \${port}\`);
+  });
+
+  server.on('error', (error: NodeJS.ErrnoException) => {
+    if (error.code === 'EADDRINUSE') {
+      const randomPort = Math.floor(Math.random() * (65535 - 49152) + 49152);
+      console.log(\`Port \${port} is in use, trying port \${randomPort}...\`);
+      startServer(randomPort);
+    } else {
+      console.error('Failed to start server:', error);
+      process.exit(1);
+    }
+  });
+}
+
+startServer(PORT);`}
 
 // Handle server shutdown
 process.on('SIGINT', async () => {

package/dist/templates/stateful-streamable-http/readme.js

@@ -1,5 +1,11 @@
 export function getReadmeTemplate(projectName, options) {
     const withOAuth = options?.withOAuth ?? false;
+    const packageManager = options?.packageManager ?? 'npm';
+    const commands = {
+        npm: { install: 'npm install', dev: 'npm run dev', build: 'npm run build', start: 'npm start' },
+        pnpm: { install: 'pnpm install', dev: 'pnpm dev', build: 'pnpm build', start: 'pnpm start' },
+        yarn: { install: 'yarn', dev: 'yarn dev', build: 'yarn build', start: 'yarn start' },
+    }[packageManager];
     const description = withOAuth
         ? 'A stateful streamable HTTP MCP (Model Context Protocol) server with session management and OAuth authentication.'
         : 'A stateful streamable HTTP MCP (Model Context Protocol) server with session management.';
@@ -85,14 +91,14 @@ This project was created with [@agentailor/create-mcp-server](https://www.npmjs.
 
 \`\`\`bash
 # Install dependencies
-npm install
+${commands.install}
 
 # Build and run in development
-npm run dev
+${commands.dev}
 
 # Or build and start separately
-npm run build
-npm start
+${commands.build}
+${commands.start}
 \`\`\`
 
 The server will start on port 3000 by default. You can change this by setting the \`PORT\` environment variable.

package/dist/templates/stateful-streamable-http/templates.test.js

@@ -83,10 +83,12 @@ describe('stateful-streamable-http templates', () => {
             const template = getReadmeTemplate(projectName);
             expect(template).toContain(`# ${projectName}`);
         });
-        it('should include getting started instructions', () => {
+        it('should include getting started instructions with npm by default', () => {
             const template = getReadmeTemplate(projectName);
             expect(template).toContain('npm install');
             expect(template).toContain('npm run dev');
+            expect(template).toContain('npm run build');
+            expect(template).toContain('npm start');
         });
         it('should document the /mcp endpoint', () => {
             const template = getReadmeTemplate(projectName);
@@ -108,6 +110,31 @@ describe('stateful-streamable-http templates', () => {
             expect(template).toContain('DELETE /mcp');
         });
     });
+    describe('getReadmeTemplate with package manager', () => {
+        it('should use npm commands when packageManager is npm', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'npm' });
+            expect(template).toContain('npm install');
+            expect(template).toContain('npm run dev');
+            expect(template).toContain('npm run build');
+            expect(template).toContain('npm start');
+        });
+        it('should use pnpm commands when packageManager is pnpm', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'pnpm' });
+            expect(template).toContain('pnpm install');
+            expect(template).toContain('pnpm dev');
+            expect(template).toContain('pnpm build');
+            expect(template).toContain('pnpm start');
+            expect(template).not.toContain('npm run');
+        });
+        it('should use yarn commands when packageManager is yarn', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'yarn' });
+            expect(template).toContain('yarn\n');
+            expect(template).toContain('yarn dev');
+            expect(template).toContain('yarn build');
+            expect(template).toContain('yarn start');
+            expect(template).not.toContain('npm run');
+        });
+    });
     describe('getIndexTemplate with OAuth', () => {
         it('should include auth imports when OAuth enabled', () => {
             const template = getIndexTemplate({ withOAuth: true });

package/dist/templates/streamable-http/index.d.ts

@@ -1,5 +1,6 @@
 export interface TemplateOptions {
     withOAuth?: boolean;
+    packageManager?: 'npm' | 'pnpm' | 'yarn';
 }
 export declare function getIndexTemplate(options?: TemplateOptions): string;
 export { getServerTemplate } from './server.js';

package/dist/templates/streamable-http/index.js

@@ -66,13 +66,25 @@ app.delete('/mcp', async (req: Request, res: Response) => {
 
 // Start the server
 const PORT = process.env.PORT || 3000;
-app.listen(PORT, (error) => {
-  if (error) {
-    console.error('Failed to start server:', error);
-    process.exit(1);
-  }
-  console.log(\`MCP Streamable HTTP Server listening on port \${PORT}\`);
-});
+
+function startServer(port: number | string): void {
+  const server = app.listen(port, () => {
+    console.log(\`MCP Streamable HTTP Server listening on port \${port}\`);
+  });
+
+  server.on('error', (error: NodeJS.ErrnoException) => {
+    if (error.code === 'EADDRINUSE') {
+      const randomPort = Math.floor(Math.random() * (65535 - 49152) + 49152);
+      console.log(\`Port \${port} is in use, trying port \${randomPort}...\`);
+      startServer(randomPort);
+    } else {
+      console.error('Failed to start server:', error);
+      process.exit(1);
+    }
+  });
+}
+
+startServer(PORT);
 
 // Handle server shutdown
 process.on('SIGINT', async () => {

package/dist/templates/streamable-http/readme.js

@@ -1,6 +1,10 @@
-// Options parameter added for type consistency with stateful template (OAuth not supported in stateless)
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export function getReadmeTemplate(projectName, options) {
+    const packageManager = options?.packageManager ?? 'npm';
+    const commands = {
+        npm: { install: 'npm install', dev: 'npm run dev', build: 'npm run build', start: 'npm start' },
+        pnpm: { install: 'pnpm install', dev: 'pnpm dev', build: 'pnpm build', start: 'pnpm start' },
+        yarn: { install: 'yarn', dev: 'yarn dev', build: 'yarn build', start: 'yarn start' },
+    }[packageManager];
     return `# ${projectName}
 
 A stateless streamable HTTP MCP (Model Context Protocol) server.
@@ -13,14 +17,14 @@ This project was created with [@agentailor/create-mcp-server](https://www.npmjs.
 
 \`\`\`bash
 # Install dependencies
-npm install
+${commands.install}
 
 # Build and run in development
-npm run dev
+${commands.dev}
 
 # Or build and start separately
-npm run build
-npm start
+${commands.build}
+${commands.start}
 \`\`\`
 
 The server will start on port 3000 by default. You can change this by setting the \`PORT\` environment variable.

package/dist/templates/streamable-http/templates.test.js

@@ -63,10 +63,12 @@ describe('streamable-http templates', () => {
             const template = getReadmeTemplate(projectName);
             expect(template).toContain(`# ${projectName}`);
         });
-        it('should include getting started instructions', () => {
+        it('should include getting started instructions with npm by default', () => {
             const template = getReadmeTemplate(projectName);
             expect(template).toContain('npm install');
             expect(template).toContain('npm run dev');
+            expect(template).toContain('npm run build');
+            expect(template).toContain('npm start');
         });
         it('should document the /mcp endpoint', () => {
             const template = getReadmeTemplate(projectName);
@@ -77,4 +79,29 @@ describe('streamable-http templates', () => {
             expect(template).toContain('stateless');
         });
     });
+    describe('getReadmeTemplate with package manager', () => {
+        it('should use npm commands when packageManager is npm', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'npm' });
+            expect(template).toContain('npm install');
+            expect(template).toContain('npm run dev');
+            expect(template).toContain('npm run build');
+            expect(template).toContain('npm start');
+        });
+        it('should use pnpm commands when packageManager is pnpm', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'pnpm' });
+            expect(template).toContain('pnpm install');
+            expect(template).toContain('pnpm dev');
+            expect(template).toContain('pnpm build');
+            expect(template).toContain('pnpm start');
+            expect(template).not.toContain('npm run');
+        });
+        it('should use yarn commands when packageManager is yarn', () => {
+            const template = getReadmeTemplate(projectName, { packageManager: 'yarn' });
+            expect(template).toContain('yarn\n');
+            expect(template).toContain('yarn dev');
+            expect(template).toContain('yarn build');
+            expect(template).toContain('yarn start');
+            expect(template).not.toContain('npm run');
+        });
+    });
 });

package/package.json

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