openscad-mcp-server 1.0.5 → 1.0.6

package/README.md

@@ -59,6 +59,14 @@ The published package is intended to run over stdio. Configure it in your MCP cl
 }
 ```
 
+To run it over HTTP instead (e.g. in Docker), pass `--http`:
+
+```bash
+MCP_PORT=3000 npx -y openscad-mcp-server --http
+```
+
+The server exposes `GET /health` and a stateless streamable HTTP MCP endpoint at `POST /mcp`.
+
 ### Using the Skill
 
 [Agents skills](https://github.com/agentskills/agentskills) are a simple, open format for giving agents new capabilities and expertise.
@@ -73,7 +81,7 @@ npx skills add fboldo/openscad-mcp-server --skill openscad-iterative-modeling
 
 - Install deps: `bun install`
 - Stdio (matches how clients run it): `bun index.ts --stdio`
-- HTTP (useful for manual testing): `bun index.ts`
+- HTTP (useful for manual testing): `bun index.ts` (or `--http`)
   - Port: `MCP_PORT` (default `3000`)
   - Endpoints: `GET /health`, MCP at `POST /mcp`
 - MCP Inspector: `bun run dev`

package/dist/index.mjs

@@ -273,8 +273,13 @@ function createServer() {
 
 //#endregion
 //#region src/entrypoints/http.ts
-const createHttpServer = async (createServer) => {
-	const transport = new WebStandardStreamableHTTPServerTransport();
+/**
+* Creates the Hono app serving the MCP endpoint in stateless mode.
+*
+* Stateless transports cannot be reused across requests, so a fresh server and
+* transport pair is created for every `/mcp` request and closed once it has responded.
+*/
+const createHttpApp = (createServer) => {
 	const app = new Hono();
 	app.use("*", cors({
 		origin: "*",
@@ -293,9 +298,24 @@ const createHttpServer = async (createServer) => {
 		exposeHeaders: ["mcp-session-id", "mcp-protocol-version"]
 	}));
 	app.get("/health", (c) => c.json({ status: "ok" }));
-	app.all("/mcp", (c) => transport.handleRequest(c.req.raw));
+	app.all("/mcp", async (c) => {
+		const transport = new WebStandardStreamableHTTPServerTransport({
+			sessionIdGenerator: void 0,
+			enableJsonResponse: true
+		});
+		const server = createServer();
+		try {
+			await server.connect(transport);
+			return await transport.handleRequest(c.req.raw);
+		} finally {
+			await server.close();
+		}
+	});
+	return app;
+};
+const createHttpServer = async (createServer) => {
+	const app = createHttpApp(createServer);
 	const PORT = process.env.MCP_PORT ? Number.parseInt(process.env.MCP_PORT, 10) : 3e3;
-	await createServer().connect(transport);
 	console.log(`Starting Hono MCP server on port ${PORT}`);
 	console.log(`Health check: http://localhost:${PORT}/health`);
 	console.log(`MCP endpoint: http://localhost:${PORT}/mcp`);
@@ -330,7 +350,16 @@ const bootstrap = (method, createServer) => {
 
 //#endregion
 //#region index.ts
-await bootstrap((process.argv.includes("--stdio"), "stdio"), createServer);
+/**
+* Explicit `--http` / `--stdio` flags win. Without a flag, the published build
+* (NODE_ENV=production) defaults to stdio and local development defaults to HTTP.
+*/
+const resolveBootstrapMethod = (argv) => {
+	if (argv.includes("--http")) return "http";
+	if (argv.includes("--stdio")) return "stdio";
+	return "stdio";
+};
+await bootstrap(resolveBootstrapMethod(process.argv), createServer);
 
 //#endregion
 export {  };

package/package.json

@@ -3,7 +3,7 @@
   "module": "./dist/index.mjs",
   "type": "module",
   "license": "MIT",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "mcpName": "io.github.fboldo/openscad-mcp-server",
   "description": "An MCP server that renders PNG previews and STL geometry from OpenSCAD (SCAD) source code.",
   "repository": {

package/server.json

@@ -8,13 +8,13 @@
     "url": "https://github.com/fboldo/openscad-mcp-server",
     "source": "github"
   },
-  "version": "1.0.5",
+  "version": "1.0.6",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "openscad-mcp-server",
-      "version": "1.0.5",
+      "version": "1.0.6",
       "transport": {
         "type": "stdio"
       }