fix(http): create transport per request for stateless mode

The StreamableHTTPServerTransport requires a fresh transport + server
connection per request in stateless mode. Previous implementation
reused a single transport instance, causing requests to hang.

Author: johnleider

Dockerfile

@@ -18,4 +18,4 @@ RUN pnpm build
 EXPOSE 3000
 
 # Start server with HTTP transport
-CMD ["node", "bin/cli.js", "--transport=http", "--host=0.0.0.0", "--port=3000", "--path=/mcp", "--stateless"]
+CMD ["node", "bin/cli.js", "--transport=http", "--host=0.0.0.0", "--port=3000", "--path=/mcp"]

src/index.ts

@@ -7,88 +7,76 @@
 import 'dotenv/config'
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 
 import { intro } from './cli/intro.js'
 import packageJson from '../package.json' with { type: 'json' }
 
 import { registerPrompts } from '#prompts/index'
 import { registerResources } from '#resources/index'
 import { registerTools } from '#tools/index'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import { HttpTransport } from '#transports/http'
-import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js'
-
-const server = new McpServer({
-  name: 'Vuetify',
-  version: packageJson.version,
-  capabilities: {
-    resources: {
-      description: 'No resources required for Vuetify assistance.',
-    },
-    tools: {
-      description: 'Tools to help with Vuetify component properties, layouts, and documentation.',
-    },
-    prompts: {
-      description: 'Prompts to assist with Vuetify component usage and best practices.',
-    },
-  },
-})
-
-await registerResources(server)
-await registerPrompts(server)
-await registerTools(server)
+import { startHttpServer } from '#transports/http'
 
 function parseArgs () {
   const args = process.argv.slice(2)
   let transport = 'stdio'
   let port = 3000
   let host = 'localhost'
   let path = '/mcp'
-  let stateless = false
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i]
     if (arg === '--transport' && i + 1 < args.length) {
       transport = args[++i]
-    }
-    else if (arg === '--port' && i + 1 < args.length) {
-      port = parseInt(args[++i], 10)
-    }
-    else if (arg === '--host' && i + 1 < args.length) {
+    } else if (arg === '--port' && i + 1 < args.length) {
+      port = Number.parseInt(args[++i], 10)
+    } else if (arg === '--host' && i + 1 < args.length) {
       host = args[++i]
-    }
-    else if (arg === '--path' && i + 1 < args.length) {
+    } else if (arg === '--path' && i + 1 < args.length) {
       path = args[++i]
     }
-    else if (arg === '--stateless') {
-      stateless = true
-    }
   }
 
-  return { transport, port, host, path, stateless }
+  return { transport, port, host, path }
 }
 
-function createTransport (options: ReturnType<typeof parseArgs>): Transport {
+async function main () {
+  const options = parseArgs()
+
   if (options.transport === 'http') {
-    return new HttpTransport({
+    // HTTP transport handles its own server creation per-request
+    await startHttpServer({
       port: options.port,
       host: options.host,
       path: options.path,
-      stateless: options.stateless,
     })
-  }
-  return new StdioServerTransport()
-}
+  } else {
+    // Stdio transport - single server instance
+    intro()
 
-async function main () {
-  const options = parseArgs()
+    const server = new McpServer({
+      name: 'Vuetify',
+      version: packageJson.version,
+      capabilities: {
+        resources: {
+          description: 'No resources required for Vuetify assistance.',
+        },
+        tools: {
+          description: 'Tools to help with Vuetify component properties, layouts, and documentation.',
+        },
+        prompts: {
+          description: 'Prompts to assist with Vuetify component usage and best practices.',
+        },
+      },
+    })
 
-  if (options.transport === 'stdio') {
-    intro()
-  }
+    await registerResources(server)
+    await registerPrompts(server)
+    await registerTools(server)
 
-  const transport = createTransport(options)
-  await server.connect(transport)
+    const transport = new StdioServerTransport()
+    await server.connect(transport)
+  }
 }
 
 main().catch(error => {