feat(gateway): implement MCP endpoint and enhance logging for session management

Author: Lasim

README.md

@@ -107,6 +107,7 @@ Our roadmap is designed to build the essential infrastructure for using MCP secu
 - **[Done]** Implemented secure authentication and configuration synchronization between the Gateway and the cloud.
 - **[Done]** Built the on-demand `stdio` process spawning and management logic.
 - **[Done]** Added support for multi-user teams with role-based access control.
+- **[Done]** Implemented dual transport architecture supporting both SSE and Streamable HTTP transports for maximum client compatibility.
 
 ### Phase 3: Enterprise Governance (Current Focus)
 

services/gateway/README.md

@@ -4,7 +4,7 @@ The local secure gateway that connects developers to their team's MCP servers th
 
 ## 🔍 Features
 
-- **Dual Transport Architecture**: Supports SSE transport for VS Code compatibility with session-based messaging
+- **Dual Transport Architecture**: Supports both legacy SSE transport and modern Streamable HTTP transport for maximum MCP client compatibility
 - **Individual Tool Exposure**: Exposes individual MCP tools with namespacing (e.g., `brightdata-search_engine`) for direct use
 - **Automatic Tool Discovery**: Discovers and caches tools from all MCP servers when switching teams
 - **Fast Gateway Startup**: Instant startup using cached tools without waiting for server discovery
@@ -110,8 +110,9 @@ After logging in, the gateway automatically downloads and synchronizes your team
 
 **Gateway Endpoints:**
 
-- 📡 **SSE Connection**: `http://localhost:9095/sse` (for establishing connections)
-- 📨 **Messages**: `http://localhost:9095/message` (for JSON-RPC with session context)  
+- 📡 **SSE Connection**: `http://localhost:9095/sse` (for establishing legacy SSE connections)
+- 📨 **Messages**: `http://localhost:9095/message` (for JSON-RPC with session context)
+- 🚀 **MCP Endpoint**: `http://localhost:9095/mcp` (for modern Streamable HTTP transport)
 - 📊 **Health Check**: `http://localhost:9095/health` (for monitoring)
 - 📋 **Status**: `http://localhost:9095/status` (for detailed information)
 
@@ -293,6 +294,7 @@ deploystack start --foreground
 🚀 DeployStack Gateway listening at:
    📡 SSE endpoint: http://localhost:9095/sse
    📨 Messages: http://localhost:9095/message
+   🚀 MCP endpoint: http://localhost:9095/mcp
    📊 Health check: http://localhost:9095/health
 🤖 Ready to serve 2 MCP servers for team: kaka
 ```

services/gateway/src/commands/restart.ts

@@ -35,6 +35,7 @@ export function registerRestartCommand(program: Command) {
           console.log(chalk.gray(`   PID: ${result.pid}`));
           console.log(chalk.gray(`   SSE endpoint: ${result.endpoints?.sse}`));
           console.log(chalk.gray(`   Messages: ${result.endpoints?.messages}`));
+          console.log(chalk.gray(`   MCP endpoint: ${result.endpoints?.mcp}`));
           console.log(chalk.gray('   Use "deploystack status" to check status'));
           console.log(chalk.gray('   Use "deploystack stop" to stop the server'));
 

services/gateway/src/commands/start.ts

@@ -40,6 +40,7 @@ export function registerStartCommand(program: Command) {
           console.log(chalk.gray(`   PID: ${result.pid}`));
           console.log(chalk.gray(`   SSE endpoint: ${result.endpoints?.sse}`));
           console.log(chalk.gray(`   Messages: ${result.endpoints?.messages}`));
+          console.log(chalk.gray(`   MCP endpoint: ${result.endpoints?.mcp}`));
           console.log(chalk.gray('   Use "deploystack status" to check status'));
           console.log(chalk.gray('   Use "deploystack stop" to stop the server'));
 

services/gateway/src/commands/status.ts

@@ -44,7 +44,8 @@ async function getGatewayStatus() {
       pid: null as number | null,
       uptime: null as number | null,
       endpointSSE: null as string | null,
-      endpointMessages: null as string | null
+      endpointMessages: null as string | null,
+      endpointMcp: null as string | null
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     server: null as any,
@@ -86,10 +87,12 @@ async function getGatewayStatus() {
         const host = 'localhost'; // Default host
         status.gateway.endpointSSE = `http://${host}:${port}/sse`;
         status.gateway.endpointMessages = `http://${host}:${port}/message`;
+        status.gateway.endpointMcp = `http://${host}:${port}/mcp`;
       } catch {
         // Server might be starting up or not responding
         status.gateway.endpointSSE = 'http://localhost:9095/sse (not responding)';
         status.gateway.endpointMessages = 'http://localhost:9095/message (not responding)';
+        status.gateway.endpointMcp = 'http://localhost:9095/mcp (not responding)';
       }
     }
   }
@@ -144,8 +147,9 @@ async function displayStatus(status: any, verbose: boolean, _compare: boolean =
     ['Status', status.gateway.running ? chalk.green('Running') : chalk.red('Stopped')],
     ['PID', status.gateway.pid || chalk.gray('N/A')],
     ['Uptime', status.gateway.uptime ? formatUptime(status.gateway.uptime) : chalk.gray('N/A')],
-    ['Endpoint SSE', status.gateway.endpointSSE || chalk.gray('N/A')],
-    ['Endpoint Messages', status.gateway.endpointMessages || chalk.gray('N/A')]
+    ['SSE Endpoint', status.gateway.endpointSSE || chalk.gray('N/A')],
+    ['Messages', status.gateway.endpointMessages || chalk.gray('N/A')],
+    ['MCP Endpoint', status.gateway.endpointMcp || chalk.gray('N/A')]
   );
 
   console.log(gatewayTable.toString());