@mcp-ts/sdk 1.0.0

package/dist/client/index.mjs

@@ -0,0 +1,223 @@
+import { nanoid } from 'nanoid';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var SSEClient = class {
+  constructor(options) {
+    this.options = options;
+    __publicField(this, "eventSource", null);
+    __publicField(this, "pendingRequests", /* @__PURE__ */ new Map());
+    __publicField(this, "reconnectAttempts", 0);
+    __publicField(this, "maxReconnectAttempts", 5);
+    __publicField(this, "reconnectDelay", 1e3);
+    __publicField(this, "isManuallyDisconnected", false);
+    __publicField(this, "connectionPromise", null);
+    __publicField(this, "connectionResolver", null);
+  }
+  /**
+   * Connect to SSE endpoint
+   */
+  connect() {
+    if (this.eventSource) {
+      return;
+    }
+    this.isManuallyDisconnected = false;
+    this.options.onStatusChange?.("connecting");
+    this.connectionPromise = new Promise((resolve) => {
+      this.connectionResolver = resolve;
+    });
+    const url = new URL(this.options.url, typeof window !== "undefined" ? window.location.origin : void 0);
+    url.searchParams.set("identity", this.options.identity);
+    if (this.options.authToken) {
+      url.searchParams.set("token", this.options.authToken);
+    }
+    this.eventSource = new EventSource(url.toString());
+    this.eventSource.addEventListener("open", () => {
+      console.log("[SSEClient] Connected");
+      this.reconnectAttempts = 0;
+      this.options.onStatusChange?.("connected");
+    });
+    this.eventSource.addEventListener("connected", (e) => {
+      const data = JSON.parse(e.data);
+      console.log("[SSEClient] Server ready:", data);
+      if (this.connectionResolver) {
+        this.connectionResolver();
+        this.connectionResolver = null;
+      }
+    });
+    this.eventSource.addEventListener("connection", (e) => {
+      const event = JSON.parse(e.data);
+      this.options.onConnectionEvent?.(event);
+    });
+    this.eventSource.addEventListener("observability", (e) => {
+      const event = JSON.parse(e.data);
+      this.options.onObservabilityEvent?.(event);
+    });
+    this.eventSource.addEventListener("rpc-response", (e) => {
+      const response = JSON.parse(e.data);
+      this.handleRpcResponse(response);
+    });
+    this.eventSource.addEventListener("error", () => {
+      console.error("[SSEClient] Connection error");
+      this.options.onStatusChange?.("error");
+      if (!this.isManuallyDisconnected && this.reconnectAttempts < this.maxReconnectAttempts) {
+        this.reconnectAttempts++;
+        console.log(`[SSEClient] Reconnecting (attempt ${this.reconnectAttempts})...`);
+        setTimeout(() => {
+          this.disconnect();
+          this.connect();
+        }, this.reconnectDelay * this.reconnectAttempts);
+      }
+    });
+  }
+  /**
+   * Disconnect from SSE endpoint
+   */
+  disconnect() {
+    this.isManuallyDisconnected = true;
+    if (this.eventSource) {
+      this.eventSource.close();
+      this.eventSource = null;
+    }
+    this.connectionPromise = null;
+    this.connectionResolver = null;
+    for (const [id, { reject }] of this.pendingRequests.entries()) {
+      const error = new Error("Connection closed");
+      error.name = "ConnectionClosedError";
+      reject(error);
+    }
+    this.pendingRequests.clear();
+    this.options.onStatusChange?.("disconnected");
+  }
+  /**
+   * Send RPC request via SSE
+   * Note: SSE is unidirectional (server->client), so we need to send requests via POST
+   */
+  async sendRequest(method, params) {
+    if (this.connectionPromise) {
+      await this.connectionPromise;
+    }
+    const id = `rpc_${nanoid(10)}`;
+    const request = {
+      id,
+      method,
+      params
+    };
+    const promise = new Promise((resolve, reject) => {
+      this.pendingRequests.set(id, { resolve, reject });
+      setTimeout(() => {
+        if (this.pendingRequests.has(id)) {
+          this.pendingRequests.delete(id);
+          reject(new Error("Request timeout"));
+        }
+      }, 3e4);
+    });
+    try {
+      const url = new URL(this.options.url, typeof window !== "undefined" ? window.location.origin : void 0);
+      url.searchParams.set("identity", this.options.identity);
+      await fetch(url.toString(), {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.options.authToken && { Authorization: `Bearer ${this.options.authToken}` }
+        },
+        body: JSON.stringify(request)
+      });
+    } catch (error) {
+      this.pendingRequests.delete(id);
+      throw error;
+    }
+    return promise;
+  }
+  /**
+   * Handle RPC response
+   */
+  handleRpcResponse(response) {
+    const pending = this.pendingRequests.get(response.id);
+    if (pending) {
+      this.pendingRequests.delete(response.id);
+      if (response.error) {
+        pending.reject(new Error(response.error.message));
+      } else {
+        pending.resolve(response.result);
+      }
+    }
+  }
+  /**
+   * Get all user sessions
+   */
+  async getSessions() {
+    return this.sendRequest("getSessions");
+  }
+  /**
+   * Connect to an MCP server
+   */
+  async connectToServer(params) {
+    return this.sendRequest("connect", params);
+  }
+  /**
+   * Disconnect from an MCP server
+   */
+  async disconnectFromServer(sessionId) {
+    return this.sendRequest("disconnect", { sessionId });
+  }
+  /**
+   * List tools from a session
+   */
+  async listTools(sessionId) {
+    return this.sendRequest("listTools", { sessionId });
+  }
+  /**
+   * Call a tool
+   */
+  async callTool(sessionId, toolName, toolArgs) {
+    return this.sendRequest("callTool", { sessionId, toolName, toolArgs });
+  }
+  /**
+   * Refresh/validate a session
+   */
+  async restoreSession(sessionId) {
+    return this.sendRequest("restoreSession", { sessionId });
+  }
+  /**
+   * Complete OAuth authorization
+   */
+  async finishAuth(sessionId, code) {
+    return this.sendRequest("finishAuth", { sessionId, code });
+  }
+  /**
+   * List available prompts
+   */
+  async listPrompts(sessionId) {
+    return this.sendRequest("listPrompts", { sessionId });
+  }
+  /**
+   * Get a specific prompt with arguments
+   */
+  async getPrompt(sessionId, name, args) {
+    return this.sendRequest("getPrompt", { sessionId, name, args });
+  }
+  /**
+   * List available resources
+   */
+  async listResources(sessionId) {
+    return this.sendRequest("listResources", { sessionId });
+  }
+  /**
+   * Read a specific resource
+   */
+  async readResource(sessionId, uri) {
+    return this.sendRequest("readResource", { sessionId, uri });
+  }
+  /**
+   * Check if connected
+   */
+  isConnected() {
+    return this.eventSource !== null && this.eventSource.readyState === EventSource.OPEN;
+  }
+};
+
+export { SSEClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/core/sse-client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * SSE Client for MCP Connections\r\n * Browser-side client that connects to SSE endpoint\r\n */\r\n\r\nimport { nanoid } from 'nanoid';\r\nimport type { McpConnectionEvent, McpObservabilityEvent } from '../../shared/events';\r\nimport type {\r\n  McpRpcRequest,\r\n  McpRpcResponse,\r\n  McpRpcMethod,\r\n  McpRpcParams,\r\n  ConnectParams,\r\n  SessionListResult,\r\n  ConnectResult,\r\n  DisconnectResult,\r\n  RestoreSessionResult,\r\n  FinishAuthResult,\r\n  ListToolsRpcResult,\r\n  ListPromptsResult,\r\n  ListResourcesResult,\r\n} from '../../shared/types';\r\n\r\nexport interface SSEClientOptions {\r\n  /**\r\n   * SSE endpoint URL\r\n   */\r\n  url: string;\r\n\r\n  /**\r\n   * User/Client identifier\r\n   */\r\n  identity: string;\r\n\r\n  /**\r\n   * Optional auth token\r\n   */\r\n  authToken?: string;\r\n\r\n  /**\r\n   * Connection event callback\r\n   */\r\n  onConnectionEvent?: (event: McpConnectionEvent) => void;\r\n\r\n  /**\r\n   * Observability event callback\r\n   */\r\n  onObservabilityEvent?: (event: McpObservabilityEvent) => void;\r\n\r\n  /**\r\n   * Connection status callback\r\n   */\r\n  onStatusChange?: (status: 'connecting' | 'connected' | 'disconnected' | 'error') => void;\r\n}\r\n\r\n/**\r\n * SSE Client for real-time MCP connection management\r\n */\r\nexport class SSEClient {\r\n  private eventSource: EventSource | null = null;\r\n  private pendingRequests: Map<\r\n    string,\r\n    { resolve: (value: unknown) => void; reject: (error: Error) => void }\r\n  > = new Map();\r\n  private reconnectAttempts: number = 0;\r\n  private maxReconnectAttempts: number = 5;\r\n  private reconnectDelay: number = 1000;\r\n  private isManuallyDisconnected: boolean = false;\r\n  private connectionPromise: Promise<void> | null = null;\r\n  private connectionResolver: (() => void) | null = null;\r\n\r\n  constructor(private options: SSEClientOptions) { }\r\n\r\n  /**\r\n   * Connect to SSE endpoint\r\n   */\r\n  connect(): void {\r\n    if (this.eventSource) {\r\n      return; // Already connected\r\n    }\r\n\r\n    this.isManuallyDisconnected = false;\r\n    this.options.onStatusChange?.('connecting');\r\n\r\n    // Create connection promise\r\n    this.connectionPromise = new Promise((resolve) => {\r\n      this.connectionResolver = resolve;\r\n    });\r\n\r\n    // Build URL with query params\r\n    // Handle both relative and absolute URLs\r\n    const url = new URL(this.options.url, typeof window !== 'undefined' ? window.location.origin : undefined);\r\n    url.searchParams.set('identity', this.options.identity);\r\n    if (this.options.authToken) {\r\n      url.searchParams.set('token', this.options.authToken);\r\n    }\r\n\r\n    // Create EventSource\r\n    this.eventSource = new EventSource(url.toString());\r\n\r\n    // Handle connection open\r\n    this.eventSource.addEventListener('open', () => {\r\n      console.log('[SSEClient] Connected');\r\n      this.reconnectAttempts = 0;\r\n      this.options.onStatusChange?.('connected');\r\n    });\r\n\r\n    // Handle 'connected' event - server confirms manager is ready\r\n    this.eventSource.addEventListener('connected', (e: MessageEvent) => {\r\n      const data = JSON.parse(e.data);\r\n      console.log('[SSEClient] Server ready:', data);\r\n\r\n      // Resolve connection promise - now safe to send requests\r\n      if (this.connectionResolver) {\r\n        this.connectionResolver();\r\n        this.connectionResolver = null;\r\n      }\r\n    });\r\n\r\n    // Handle 'connection' events (MCP connection state changes)\r\n    this.eventSource.addEventListener('connection', (e: MessageEvent) => {\r\n      const event: McpConnectionEvent = JSON.parse(e.data);\r\n      this.options.onConnectionEvent?.(event);\r\n    });\r\n\r\n    // Handle 'observability' events (debugging/logging)\r\n    this.eventSource.addEventListener('observability', (e: MessageEvent) => {\r\n      const event: McpObservabilityEvent = JSON.parse(e.data);\r\n      this.options.onObservabilityEvent?.(event);\r\n    });\r\n\r\n    // Handle 'rpc-response' events (RPC method responses)\r\n    this.eventSource.addEventListener('rpc-response', (e: MessageEvent) => {\r\n      const response: McpRpcResponse = JSON.parse(e.data);\r\n      this.handleRpcResponse(response);\r\n    });\r\n\r\n    // Handle errors\r\n    this.eventSource.addEventListener('error', () => {\r\n      console.error('[SSEClient] Connection error');\r\n      this.options.onStatusChange?.('error');\r\n\r\n      // Attempt reconnection\r\n      if (!this.isManuallyDisconnected && this.reconnectAttempts < this.maxReconnectAttempts) {\r\n        this.reconnectAttempts++;\r\n        console.log(`[SSEClient] Reconnecting (attempt ${this.reconnectAttempts})...`);\r\n\r\n        setTimeout(() => {\r\n          this.disconnect();\r\n          this.connect();\r\n        }, this.reconnectDelay * this.reconnectAttempts);\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Disconnect from SSE endpoint\r\n   */\r\n  disconnect(): void {\r\n    this.isManuallyDisconnected = true;\r\n\r\n    if (this.eventSource) {\r\n      this.eventSource.close();\r\n      this.eventSource = null;\r\n    }\r\n\r\n    // Reset connection promise\r\n    this.connectionPromise = null;\r\n    this.connectionResolver = null;\r\n\r\n    // Reject all pending requests with a specific error type\r\n    for (const [id, { reject }] of this.pendingRequests.entries()) {\r\n      const error = new Error('Connection closed');\r\n      error.name = 'ConnectionClosedError';\r\n      reject(error);\r\n    }\r\n    this.pendingRequests.clear();\r\n\r\n    this.options.onStatusChange?.('disconnected');\r\n  }\r\n\r\n  /**\r\n   * Send RPC request via SSE\r\n   * Note: SSE is unidirectional (server->client), so we need to send requests via POST\r\n   */\r\n  private async sendRequest<T = unknown>(method: McpRpcMethod, params?: McpRpcParams): Promise<T> {\r\n    // Wait for connection to be fully established\r\n    if (this.connectionPromise) {\r\n      await this.connectionPromise;\r\n    }\r\n\r\n    // Generate unique request ID using nanoid (e.g., \"rpc_V1StGXR8_Z5jdHi\")\r\n    const id = `rpc_${nanoid(10)}`;\r\n\r\n    const request: McpRpcRequest = {\r\n      id,\r\n      method,\r\n      params,\r\n    };\r\n\r\n    // Create promise for response\r\n    const promise = new Promise<T>((resolve, reject) => {\r\n      this.pendingRequests.set(id, { resolve: resolve as (value: unknown) => void, reject });\r\n\r\n      // Timeout after 30 seconds\r\n      setTimeout(() => {\r\n        if (this.pendingRequests.has(id)) {\r\n          this.pendingRequests.delete(id);\r\n          reject(new Error('Request timeout'));\r\n        }\r\n      }, 30000);\r\n    });\r\n\r\n    // Send request via POST to same endpoint\r\n    try {\r\n      // Handle both relative and absolute URLs\r\n      const url = new URL(this.options.url, typeof window !== 'undefined' ? window.location.origin : undefined);\r\n      url.searchParams.set('identity', this.options.identity);\r\n\r\n      await fetch(url.toString(), {\r\n        method: 'POST',\r\n        headers: {\r\n          'Content-Type': 'application/json',\r\n          ...(this.options.authToken && { Authorization: `Bearer ${this.options.authToken}` }),\r\n        },\r\n        body: JSON.stringify(request),\r\n      });\r\n    } catch (error) {\r\n      this.pendingRequests.delete(id);\r\n      throw error;\r\n    }\r\n\r\n    return promise;\r\n  }\r\n\r\n  /**\r\n   * Handle RPC response\r\n   */\r\n  private handleRpcResponse(response: McpRpcResponse): void {\r\n    const pending = this.pendingRequests.get(response.id);\r\n\r\n    if (pending) {\r\n      this.pendingRequests.delete(response.id);\r\n\r\n      if (response.error) {\r\n        pending.reject(new Error(response.error.message));\r\n      } else {\r\n        pending.resolve(response.result);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get all user sessions\r\n   */\r\n  async getSessions(): Promise<SessionListResult> {\r\n    return this.sendRequest<SessionListResult>('getSessions');\r\n  }\r\n\r\n  /**\r\n   * Connect to an MCP server\r\n   */\r\n  async connectToServer(params: ConnectParams): Promise<ConnectResult> {\r\n    return this.sendRequest<ConnectResult>('connect', params);\r\n  }\r\n\r\n  /**\r\n   * Disconnect from an MCP server\r\n   */\r\n  async disconnectFromServer(sessionId: string): Promise<DisconnectResult> {\r\n    return this.sendRequest<DisconnectResult>('disconnect', { sessionId });\r\n  }\r\n\r\n  /**\r\n   * List tools from a session\r\n   */\r\n  async listTools(sessionId: string): Promise<ListToolsRpcResult> {\r\n    return this.sendRequest<ListToolsRpcResult>('listTools', { sessionId });\r\n  }\r\n\r\n  /**\r\n   * Call a tool\r\n   */\r\n  async callTool(\r\n    sessionId: string,\r\n    toolName: string,\r\n    toolArgs: Record<string, unknown>\r\n  ): Promise<unknown> {\r\n    return this.sendRequest('callTool', { sessionId, toolName, toolArgs });\r\n  }\r\n\r\n  /**\r\n   * Refresh/validate a session\r\n   */\r\n  async restoreSession(sessionId: string): Promise<RestoreSessionResult> {\r\n    return this.sendRequest<RestoreSessionResult>('restoreSession', { sessionId });\r\n  }\r\n\r\n  /**\r\n   * Complete OAuth authorization\r\n   */\r\n  async finishAuth(sessionId: string, code: string): Promise<FinishAuthResult> {\r\n    return this.sendRequest<FinishAuthResult>('finishAuth', { sessionId, code });\r\n  }\r\n\r\n  /**\r\n   * List available prompts\r\n   */\r\n  async listPrompts(sessionId: string): Promise<ListPromptsResult> {\r\n    return this.sendRequest<ListPromptsResult>('listPrompts', { sessionId });\r\n  }\r\n\r\n  /**\r\n   * Get a specific prompt with arguments\r\n   */\r\n  async getPrompt(sessionId: string, name: string, args?: Record<string, string>): Promise<unknown> {\r\n    return this.sendRequest('getPrompt', { sessionId, name, args });\r\n  }\r\n\r\n  /**\r\n   * List available resources\r\n   */\r\n  async listResources(sessionId: string): Promise<ListResourcesResult> {\r\n    return this.sendRequest<ListResourcesResult>('listResources', { sessionId });\r\n  }\r\n\r\n  /**\r\n   * Read a specific resource\r\n   */\r\n  async readResource(sessionId: string, uri: string): Promise<unknown> {\r\n    return this.sendRequest('readResource', { sessionId, uri });\r\n  }\r\n\r\n  /**\r\n   * Check if connected\r\n   */\r\n  isConnected(): boolean {\r\n    return this.eventSource !== null && this.eventSource.readyState === EventSource.OPEN;\r\n  }\r\n}\r\n"]}

package/dist/client/react.d.mts

@@ -0,0 +1,151 @@
+import { c as McpConnectionState, M as McpConnectionEvent } from '../events-BP6WyRNh.mjs';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-BP6WyRNh.mjs';
+import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-SbDlA2VX.mjs';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-SbDlA2VX.mjs';
+export { SSEClient, SSEClientOptions } from './index.mjs';
+import '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * useMcp React Hook
+ * Manages MCP connections with SSE-based real-time updates
+ * Based on Cloudflare's agents pattern
+ */
+
+interface UseMcpOptions {
+    /**
+     * SSE endpoint URL
+     */
+    url: string;
+    /**
+     * User/Client identifier
+     */
+    identity: string;
+    /**
+     * Optional auth token
+     */
+    authToken?: string;
+    /**
+     * Auto-connect on mount
+     * @default true
+     */
+    autoConnect?: boolean;
+    /**
+     * Auto-initialize sessions on mount
+     * @default true
+     */
+    autoInitialize?: boolean;
+    /**
+     * Connection event callback
+     */
+    onConnectionEvent?: (event: McpConnectionEvent) => void;
+    /**
+     * Debug logging callback
+     */
+    onLog?: (level: string, message: string, metadata?: Record<string, unknown>) => void;
+    /**
+     * Optional callback to handle OAuth redirects (e.g. for popup flow)
+     * If provided, this will be called instead of window.location.href assignment
+     */
+    onRedirect?: (url: string) => void;
+}
+interface McpConnection {
+    sessionId: string;
+    serverId: string;
+    serverName: string;
+    serverUrl?: string;
+    transport?: string;
+    state: McpConnectionState;
+    tools: ToolInfo[];
+    error?: string;
+    connectedAt?: Date;
+}
+interface McpClient {
+    /**
+     * All connections
+     */
+    connections: McpConnection[];
+    /**
+     * SSE connection status
+     */
+    status: 'connecting' | 'connected' | 'disconnected' | 'error';
+    /**
+     * Whether initializing
+     */
+    isInitializing: boolean;
+    /**
+     * Connect to an MCP server
+     */
+    connect: (params: {
+        serverId: string;
+        serverName: string;
+        serverUrl: string;
+        callbackUrl: string;
+        transportType?: 'sse' | 'streamable_http';
+    }) => Promise<string>;
+    /**
+     * Disconnect from an MCP server
+     */
+    disconnect: (sessionId: string) => Promise<void>;
+    /**
+     * Get connection by session ID
+     */
+    getConnection: (sessionId: string) => McpConnection | undefined;
+    /**
+     * Get connection by server ID
+     */
+    getConnectionByServerId: (serverId: string) => McpConnection | undefined;
+    /**
+     * Check if server is connected
+     */
+    isServerConnected: (serverId: string) => boolean;
+    /**
+     * Get tools for a session
+     */
+    getTools: (sessionId: string) => ToolInfo[];
+    /**
+     * Refresh all connections
+     */
+    refresh: () => Promise<void>;
+    /**
+     * Manually connect SSE
+     */
+    connectSSE: () => void;
+    /**
+     * Manually disconnect SSE
+     */
+    disconnectSSE: () => void;
+    /**
+     * Complete OAuth authorization
+     */
+    finishAuth: (sessionId: string, code: string) => Promise<FinishAuthResult>;
+    /**
+     * Call a tool from a session
+     */
+    callTool: (sessionId: string, toolName: string, toolArgs: Record<string, unknown>) => Promise<unknown>;
+    /**
+     * List available tools for a session
+     */
+    listTools: (sessionId: string) => Promise<ListToolsRpcResult>;
+    /**
+     * List available prompts for a session
+     */
+    listPrompts: (sessionId: string) => Promise<ListPromptsResult>;
+    /**
+     * Get a specific prompt with arguments
+     */
+    getPrompt: (sessionId: string, name: string, args?: Record<string, string>) => Promise<unknown>;
+    /**
+     * List available resources for a session
+     */
+    listResources: (sessionId: string) => Promise<ListResourcesResult>;
+    /**
+     * Read a specific resource
+     */
+    readResource: (sessionId: string, uri: string) => Promise<unknown>;
+}
+/**
+ * React hook for MCP connection management with SSE
+ */
+declare function useMcp(options: UseMcpOptions): McpClient;
+
+export { type McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, ToolInfo, type UseMcpOptions, useMcp };

package/dist/client/react.d.ts

@@ -0,0 +1,151 @@
+import { c as McpConnectionState, M as McpConnectionEvent } from '../events-BP6WyRNh.js';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-BP6WyRNh.js';
+import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-SbDlA2VX.js';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-SbDlA2VX.js';
+export { SSEClient, SSEClientOptions } from './index.js';
+import '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * useMcp React Hook
+ * Manages MCP connections with SSE-based real-time updates
+ * Based on Cloudflare's agents pattern
+ */
+
+interface UseMcpOptions {
+    /**
+     * SSE endpoint URL
+     */
+    url: string;
+    /**
+     * User/Client identifier
+     */
+    identity: string;
+    /**
+     * Optional auth token
+     */
+    authToken?: string;
+    /**
+     * Auto-connect on mount
+     * @default true
+     */
+    autoConnect?: boolean;
+    /**
+     * Auto-initialize sessions on mount
+     * @default true
+     */
+    autoInitialize?: boolean;
+    /**
+     * Connection event callback
+     */
+    onConnectionEvent?: (event: McpConnectionEvent) => void;
+    /**
+     * Debug logging callback
+     */
+    onLog?: (level: string, message: string, metadata?: Record<string, unknown>) => void;
+    /**
+     * Optional callback to handle OAuth redirects (e.g. for popup flow)
+     * If provided, this will be called instead of window.location.href assignment
+     */
+    onRedirect?: (url: string) => void;
+}
+interface McpConnection {
+    sessionId: string;
+    serverId: string;
+    serverName: string;
+    serverUrl?: string;
+    transport?: string;
+    state: McpConnectionState;
+    tools: ToolInfo[];
+    error?: string;
+    connectedAt?: Date;
+}
+interface McpClient {
+    /**
+     * All connections
+     */
+    connections: McpConnection[];
+    /**
+     * SSE connection status
+     */
+    status: 'connecting' | 'connected' | 'disconnected' | 'error';
+    /**
+     * Whether initializing
+     */
+    isInitializing: boolean;
+    /**
+     * Connect to an MCP server
+     */
+    connect: (params: {
+        serverId: string;
+        serverName: string;
+        serverUrl: string;
+        callbackUrl: string;
+        transportType?: 'sse' | 'streamable_http';
+    }) => Promise<string>;
+    /**
+     * Disconnect from an MCP server
+     */
+    disconnect: (sessionId: string) => Promise<void>;
+    /**
+     * Get connection by session ID
+     */
+    getConnection: (sessionId: string) => McpConnection | undefined;
+    /**
+     * Get connection by server ID
+     */
+    getConnectionByServerId: (serverId: string) => McpConnection | undefined;
+    /**
+     * Check if server is connected
+     */
+    isServerConnected: (serverId: string) => boolean;
+    /**
+     * Get tools for a session
+     */
+    getTools: (sessionId: string) => ToolInfo[];
+    /**
+     * Refresh all connections
+     */
+    refresh: () => Promise<void>;
+    /**
+     * Manually connect SSE
+     */
+    connectSSE: () => void;
+    /**
+     * Manually disconnect SSE
+     */
+    disconnectSSE: () => void;
+    /**
+     * Complete OAuth authorization
+     */
+    finishAuth: (sessionId: string, code: string) => Promise<FinishAuthResult>;
+    /**
+     * Call a tool from a session
+     */
+    callTool: (sessionId: string, toolName: string, toolArgs: Record<string, unknown>) => Promise<unknown>;
+    /**
+     * List available tools for a session
+     */
+    listTools: (sessionId: string) => Promise<ListToolsRpcResult>;
+    /**
+     * List available prompts for a session
+     */
+    listPrompts: (sessionId: string) => Promise<ListPromptsResult>;
+    /**
+     * Get a specific prompt with arguments
+     */
+    getPrompt: (sessionId: string, name: string, args?: Record<string, string>) => Promise<unknown>;
+    /**
+     * List available resources for a session
+     */
+    listResources: (sessionId: string) => Promise<ListResourcesResult>;
+    /**
+     * Read a specific resource
+     */
+    readResource: (sessionId: string, uri: string) => Promise<unknown>;
+}
+/**
+ * React hook for MCP connection management with SSE
+ */
+declare function useMcp(options: UseMcpOptions): McpClient;
+
+export { type McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, ToolInfo, type UseMcpOptions, useMcp };