@mcp-web/bridge 0.1.0

package/dist/schemas.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const MissingAuthenticationErrorMessage = "Missing authentication";
+export declare const MissingAuthenticationErrorMessageSchema: z.ZodLiteral<"Missing authentication">;
+export declare const InvalidAuthenticationErrorMessage = "Invalid authentication";
+export declare const InvalidAuthenticationErrorMessageSchema: z.ZodLiteral<"Invalid authentication">;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAC1E,eAAO,MAAM,uCAAuC,wCAA+C,CAAC;AACpG,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAC1E,eAAO,MAAM,uCAAuC,wCAA+C,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export const MissingAuthenticationErrorMessage = 'Missing authentication';
+export const MissingAuthenticationErrorMessageSchema = z.literal(MissingAuthenticationErrorMessage);
+export const InvalidAuthenticationErrorMessage = 'Invalid authentication';
+export const InvalidAuthenticationErrorMessageSchema = z.literal(InvalidAuthenticationErrorMessage);
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AAC1E,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;AACpG,MAAM,CAAC,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AAC1E,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,130 @@
+import type { McpRequestMetaParams, QueryAcceptedMessage, QueryCancelMessage, QueryCompleteBridgeMessage, QueryCompleteClientMessage, QueryFailureMessage, QueryMessage, QueryProgressMessage, ResourceMetadata, ToolMetadata } from '@mcp-web/types';
+import type * as WS from 'ws';
+import type { z } from 'zod';
+export interface AuthenticateMessage {
+    type: 'authenticate';
+    sessionId: string;
+    authToken: string;
+    origin: string;
+    pageTitle?: string;
+    sessionName?: string;
+    userAgent?: string;
+    timestamp: number;
+}
+export interface AuthenticatedMessage {
+    type: 'authenticated';
+    mcpPort?: number;
+    sessionId: string;
+    success: boolean;
+}
+export interface AuthenticationFailedMessage {
+    type: 'authentication-failed';
+    error: string;
+    code: string;
+}
+export interface RegisterToolMessage {
+    type: 'register-tool';
+    tool: {
+        name: string;
+        description: string;
+        inputSchema?: z.core.JSONSchema.JSONSchema;
+        outputSchema?: z.core.JSONSchema.JSONSchema;
+        _meta?: Record<string, unknown>;
+    };
+}
+export interface RegisterResourceMessage {
+    type: 'register-resource';
+    resource: ResourceMetadata;
+}
+export interface ResourceReadMessage {
+    type: 'resource-read';
+    requestId: string;
+    uri: string;
+}
+export interface ResourceResponseMessage {
+    type: 'resource-response';
+    requestId: string;
+    content?: string;
+    blob?: string;
+    mimeType: string;
+    error?: string;
+}
+export interface ActivityMessage {
+    type: 'activity';
+    timestamp: number;
+}
+export interface ToolCallMessage {
+    type: 'tool-call';
+    requestId: string;
+    toolName: string;
+    toolInput?: Record<string, unknown>;
+    queryId?: string;
+}
+export interface ToolRegistrationErrorMessage {
+    type: 'tool-registration-error';
+    toolName: string;
+    error: string;
+    message: string;
+}
+export interface ToolResponseMessage {
+    type: 'tool-response';
+    requestId: string;
+    result: unknown;
+}
+export type FrontendMessage = AuthenticateMessage | RegisterToolMessage | RegisterResourceMessage | ActivityMessage | ToolResponseMessage | ResourceResponseMessage | QueryMessage | QueryCompleteClientMessage | QueryProgressMessage | QueryCancelMessage;
+export type BridgeMessage = AuthenticatedMessage | AuthenticationFailedMessage | ToolCallMessage | ToolRegistrationErrorMessage | ResourceReadMessage | QueryAcceptedMessage | QueryProgressMessage | QueryCompleteBridgeMessage | QueryFailureMessage | QueryCancelMessage;
+export interface TrackedToolCall {
+    tool: string;
+    arguments: unknown;
+    result: unknown;
+}
+export type QueryState = 'active' | 'completed' | 'failed' | 'cancelled';
+export interface QueryTracking {
+    sessionId: string;
+    responseTool?: string;
+    toolCalls: TrackedToolCall[];
+    ws: WS.WebSocket;
+    state: QueryState;
+    tools?: ToolMetadata[];
+    restrictTools?: boolean;
+}
+export interface McpRequest {
+    jsonrpc: string;
+    id: string | number;
+    method: string;
+    params?: {
+        name?: string;
+        arguments?: Record<string, unknown>;
+        _meta?: McpRequestMetaParams;
+    };
+}
+export interface McpResponse {
+    jsonrpc: string;
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema?: z.core.JSONSchema.JSONSchema;
+    outputSchema?: z.core.JSONSchema.JSONSchema;
+    handler?: string;
+}
+export interface SessionData {
+    ws: WS.WebSocket;
+    authToken: string;
+    origin: string;
+    pageTitle?: string;
+    sessionName?: string;
+    userAgent?: string;
+    connectedAt: number;
+    lastActivity: number;
+    tools: Map<string, ToolDefinition>;
+    resources: Map<string, ResourceMetadata>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@mcp-web/bridge",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./bridge": "./dist/bridge.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "ws": "^8.18.0",
+    "zod": "~4.1.12",
+    "@mcp-web/types": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@types/ws": "^8.5.13",
+    "typescript": "~5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "test": "bun test"
+  }
+}

package/src/adapters/bun.ts

@@ -0,0 +1,354 @@
+/**
+ * MCPWebBridgeBun - Bun adapter for the MCP Web Bridge.
+ *
+ * Uses Bun.serve() with built-in WebSocket support for a single-port server.
+ * Bun's server natively handles both HTTP and WebSocket on the same port.
+ *
+ * @example
+ * ```typescript
+ * // server.ts
+ * import { MCPWebBridgeBun } from '@mcp-web/bridge';
+ *
+ * const bridge = new MCPWebBridgeBun({
+ *   name: 'My App',
+ *   description: 'My awesome app',
+ *   port: 3001,
+ * });
+ *
+ * // Bridge is now listening on ws://localhost:3001 and http://localhost:3001
+ * ```
+ *
+ * @example Production deployment
+ * ```typescript
+ * import { MCPWebBridgeBun } from '@mcp-web/bridge';
+ *
+ * const bridge = new MCPWebBridgeBun({
+ *   name: 'Production Bridge',
+ *   description: 'Production MCP Web bridge server',
+ *   port: Number(process.env.PORT) || 3001,
+ *   hostname: '0.0.0.0',
+ * });
+ *
+ * // Graceful shutdown
+ * process.on('SIGTERM', async () => {
+ *   await bridge.close();
+ *   process.exit(0);
+ * });
+ * ```
+ *
+ * @remarks
+ * This adapter requires Bun runtime (https://bun.sh).
+ * Bun's `Bun.serve()` provides excellent performance with native WebSocket support.
+ *
+ * Key features:
+ * - Single port for HTTP and WebSocket
+ * - Native TypeScript support
+ * - High performance HTTP and WebSocket handling
+ *
+ * @see https://bun.sh/docs/api/http
+ * @see https://bun.sh/docs/api/websockets
+ */
+
+import type { MCPWebConfig } from '@mcp-web/types';
+import { MCPWebBridge } from '../core.js';
+import { TimerScheduler } from '../runtime/scheduler.js';
+import type { HttpRequest, WebSocketConnection } from '../runtime/types.js';
+import { isSSEResponse } from '../runtime/types.js';
+
+/**
+ * Configuration for the Bun bridge adapter.
+ */
+export interface MCPWebBridgeBunConfig extends Omit<MCPWebConfig, 'bridgeUrl'> {
+  /** Port to listen on (default: 3001) */
+  port?: number;
+
+  /** Hostname to bind to (default: '0.0.0.0') */
+  hostname?: string;
+}
+
+/**
+ * WebSocket data attached to each connection for session tracking.
+ */
+interface WebSocketData {
+  sessionId: string;
+  wrapped: WebSocketConnection;
+  messageHandlers: Set<(data: string) => void>;
+  // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+  setSocket: (socket: any) => void;
+  handlers: ReturnType<MCPWebBridge['getHandlers']>;
+  url: URL;
+}
+
+/**
+ * Wraps a Bun ServerWebSocket in our runtime-agnostic interface.
+ */
+function createBunWebSocketWrapper(): {
+  wrapped: WebSocketConnection;
+  messageHandlers: Set<(data: string) => void>;
+  // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+  setSocket: (socket: any) => void;
+} {
+  const messageHandlers = new Set<(data: string) => void>();
+  // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+  let wsSocket: any = null;
+
+  const wrapped: WebSocketConnection = {
+    send(data: string): void {
+      if (wsSocket?.readyState === 1) {
+        // OPEN
+        wsSocket.send(data);
+      }
+    },
+
+    close(code?: number, reason?: string): void {
+      wsSocket?.close(code, reason);
+    },
+
+    get readyState(): 'CONNECTING' | 'OPEN' | 'CLOSING' | 'CLOSED' {
+      if (!wsSocket) return 'CLOSED';
+      switch (wsSocket.readyState) {
+        case 0:
+          return 'CONNECTING';
+        case 1:
+          return 'OPEN';
+        case 2:
+          return 'CLOSING';
+        case 3:
+        default:
+          return 'CLOSED';
+      }
+    },
+
+    onMessage(handler: (data: string) => void): void {
+      messageHandlers.add(handler);
+    },
+
+    offMessage(handler: (data: string) => void): void {
+      messageHandlers.delete(handler);
+    },
+  };
+
+  return {
+    wrapped,
+    messageHandlers,
+    // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+    setSocket: (socket: any) => {
+      wsSocket = socket;
+    },
+  };
+}
+
+/**
+ * Wraps a Bun Request in our runtime-agnostic HttpRequest interface.
+ */
+function wrapBunRequest(req: Request): HttpRequest {
+  return {
+    method: req.method,
+    url: req.url,
+    headers: {
+      get(name: string): string | null {
+        return req.headers.get(name);
+      },
+    },
+    text(): Promise<string> {
+      return req.text();
+    },
+  };
+}
+
+/**
+ * Bun adapter for MCPWebBridge.
+ * Provides a single-port server using Bun.serve() with native WebSocket support.
+ *
+ * @example
+ * ```typescript
+ * const bridge = new MCPWebBridgeBun({
+ *   name: 'My App',
+ *   description: 'My app',
+ *   port: 3001,
+ * });
+ * ```
+ */
+export class MCPWebBridgeBun {
+  #core: MCPWebBridge;
+  // biome-ignore lint/suspicious/noExplicitAny: Bun.Server type varies
+  #server: any;
+  #port: number;
+  #hostname: string;
+
+  constructor(config: MCPWebBridgeBunConfig) {
+    this.#port = config.port ?? 3001;
+    this.#hostname = config.hostname ?? '0.0.0.0';
+
+    // Create the core with a timer-based scheduler
+    const scheduler = new TimerScheduler();
+    this.#core = new MCPWebBridge(config, scheduler);
+    const handlers = this.#core.getHandlers();
+
+    // Start Bun server with WebSocket support
+    // biome-ignore lint/suspicious/noExplicitAny: Bun global is runtime-specific
+    this.#server = (globalThis as any).Bun.serve({
+      port: this.#port,
+      hostname: this.#hostname,
+
+      // Handle HTTP requests
+      fetch: async (req: Request, server: { upgrade: (req: Request, options: { data: WebSocketData }) => boolean }) => {
+        const url = new URL(req.url);
+
+      // Handle WebSocket upgrade
+      if (req.headers.get('upgrade')?.toLowerCase() === 'websocket') {
+        const sessionId = url.searchParams.get('session');
+
+        if (!sessionId) {
+          return new Response('Missing session parameter', { status: 400 });
+        }
+
+        const { wrapped, messageHandlers, setSocket } = createBunWebSocketWrapper();
+
+        const success = server.upgrade(req, {
+          data: {
+            sessionId,
+            wrapped,
+            // Store these for the websocket handlers
+            messageHandlers,
+            setSocket,
+            handlers,
+            url,
+          } as WebSocketData,
+        });
+
+        if (success) {
+          return undefined as unknown as Response; // Bun handles the upgrade
+        }
+
+        return new Response('WebSocket upgrade failed', { status: 500 });
+      }
+
+        // Handle regular HTTP requests
+        const wrappedReq = wrapBunRequest(req);
+        const httpResponse = await handlers.onHttpRequest(wrappedReq);
+
+        // Check if this is an SSE response
+        if (isSSEResponse(httpResponse)) {
+          // Create a ReadableStream for SSE
+          const stream = new ReadableStream({
+            start(controller) {
+              // Create writer function that sends SSE-formatted data
+              const writer = (data: string): void => {
+                controller.enqueue(new TextEncoder().encode(`data: ${data}\n\n`));
+              };
+
+              // Set up the SSE stream
+              httpResponse.setup(writer, () => {
+                controller.close();
+              });
+
+              // Keep connection alive with periodic comments
+              const keepAlive = setInterval(() => {
+                try {
+                  controller.enqueue(new TextEncoder().encode(': keepalive\n\n'));
+                } catch {
+                  clearInterval(keepAlive);
+                }
+              }, 30000);
+            },
+          });
+
+          return new Response(stream, {
+            status: httpResponse.status,
+            headers: httpResponse.headers,
+          });
+        }
+
+        return new Response(httpResponse.body, {
+          status: httpResponse.status,
+          headers: httpResponse.headers,
+        });
+      },
+
+      // WebSocket handlers
+      websocket: {
+        // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+        open(ws: any) {
+          const data = ws.data as WebSocketData & {
+            messageHandlers: Set<(data: string) => void>;
+            // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+            setSocket: (socket: any) => void;
+            handlers: ReturnType<MCPWebBridge['getHandlers']>;
+            url: URL;
+          };
+
+          // Connect the socket to the wrapper
+          data.setSocket(ws);
+
+          // Notify the bridge
+          data.handlers.onWebSocketConnect(data.sessionId, data.wrapped, data.url);
+        },
+
+        // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+        message(ws: any, message: string | Buffer) {
+          const data = ws.data as WebSocketData & {
+            messageHandlers: Set<(data: string) => void>;
+            handlers: ReturnType<MCPWebBridge['getHandlers']>;
+          };
+
+          const str = typeof message === 'string' ? message : message.toString();
+
+          // Notify message handlers
+          for (const handler of data.messageHandlers) {
+            handler(str);
+          }
+
+          // Notify the bridge
+          data.handlers.onWebSocketMessage(data.sessionId, data.wrapped, str);
+        },
+
+        // biome-ignore lint/suspicious/noExplicitAny: Bun's ServerWebSocket type varies
+        close(ws: any) {
+          const data = ws.data as WebSocketData & {
+            handlers: ReturnType<MCPWebBridge['getHandlers']>;
+          };
+
+          data.handlers.onWebSocketClose(data.sessionId);
+        },
+
+      },
+    });
+
+    console.log(`🌉 MCP Web Bridge (Bun) listening on ${this.#hostname}:${this.#port}`);
+    console.log(`   WebSocket: ws://${this.#hostname === '0.0.0.0' ? 'localhost' : this.#hostname}:${this.#port}`);
+    console.log(`   HTTP/MCP:  http://${this.#hostname === '0.0.0.0' ? 'localhost' : this.#hostname}:${this.#port}`);
+  }
+
+  /**
+   * Get the underlying MCPWebBridge core instance.
+   */
+  get core(): MCPWebBridge {
+    return this.#core;
+  }
+
+  /**
+   * Get the bridge handlers for custom integrations.
+   */
+  getHandlers() {
+    return this.#core.getHandlers();
+  }
+
+  /**
+   * Get the port the server is listening on.
+   */
+  get port(): number {
+    return this.#port;
+  }
+
+  /**
+   * Gracefully shut down the bridge.
+   */
+  async close(): Promise<void> {
+    // Stop the server
+    this.#server?.stop();
+
+    // Close the core (cleans up sessions, timers)
+    await this.#core.close();
+  }
+}