feat: add --transport flag and support for running the MCP server via HTTP

Author: viktormarinho

package.json

@@ -45,6 +45,7 @@
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@stylistic/eslint-plugin": "^5.4.0",
     "@types/debug": "^4.1.12",
+    "@types/express": "^5.0.3",
     "@types/filesystem": "^0.0.36",
     "@types/node": "^24.3.3",
     "@types/sinon": "^17.0.4",
@@ -66,6 +67,7 @@
     "sinon": "^21.0.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.43.0",
+    "express": "^5.1.0",
     "yargs": "18.0.0"
   },
   "engines": {

src/cli.ts

@@ -154,6 +154,12 @@ export const cliOptions = {
     default: true,
     describe: 'Set to false to exlcude tools related to network.',
   },
+  transport: {
+    type: 'string',
+    description: 'Transport to use for the MCP server. Available options are: stdio, http.',
+    choices: ['stdio', 'http'] as const,
+    default: 'stdio',
+  },
 } satisfies Record<string, YargsOptions>;
 
 export function parseArguments(version: string, argv = process.argv) {
@@ -206,6 +212,7 @@ export function parseArguments(version: string, argv = process.argv) {
         'Disable tools in the performance category',
       ],
       ['$0 --no-category-network', 'Disable tools in the network category'],
+      ['$0 --transport http', 'Use HTTP transport for the MCP server'],
     ]);
 
   return yargsInstance

src/main.ts

@@ -15,6 +15,7 @@ import {McpResponse} from './McpResponse.js';
 import {Mutex} from './Mutex.js';
 import {
   McpServer,
+  StreamableHTTPServerTransport,
   StdioServerTransport,
   type CallToolResult,
   SetLevelRequestSchema,
@@ -184,7 +185,37 @@ for (const tool of tools) {
   registerTool(tool);
 }
 
-const transport = new StdioServerTransport();
-await server.connect(transport);
-logger('Chrome DevTools MCP Server connected');
-logDisclaimers();
+if (args.transport === 'stdio') {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  logger('Chrome DevTools MCP Server connected via stdio');
+  logDisclaimers();
+}
+
+if (args.transport === 'http') {
+  const { default: express } = await import('express');
+  const app = express();
+  app.use(express.json());
+
+  app.all("/mcp", async (req, res) => {
+    const transport = new StreamableHTTPServerTransport({
+      sessionIdGenerator: undefined,
+      enableJsonResponse: true,
+    });
+
+    res.on("close", () => {
+      transport.close();
+    });
+
+    await server.connect(transport);
+    return transport.handleRequest(req, res, req.body);
+  });
+
+  app.listen(3000, () => {
+    logger('Chrome DevTools MCP Server listening on port 3000 via http');
+    logDisclaimers();
+  }).on("error", (error) => {
+    logger('Chrome DevTools MCP Server error:', error);
+    process.exit(1);
+  });
+}

src/third_party/index.ts

@@ -13,6 +13,7 @@ export {debug} from 'debug';
 export type {Debugger} from 'debug';
 export {McpServer} from '@modelcontextprotocol/sdk/server/mcp.js';
 export {StdioServerTransport} from '@modelcontextprotocol/sdk/server/stdio.js';
+export {StreamableHTTPServerTransport} from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 export {
   type CallToolResult,
   SetLevelRequestSchema,