Safari MCP Server

Instructions

Implementation Reference

• src/safari-mcp-server.ts:104-114 (schema)

  Defines the tool's metadata, description, and input schema (requires sessionId) in the ListTools response.
  { name: 'safari_get_network_logs', description: 'Get network activity logs for performance analysis', inputSchema: { type: 'object', properties: { sessionId: { type: 'string', description: 'Session identifier' } }, required: ['sessionId'] } },
• src/safari-mcp-server.ts:234-235 (registration)

  Registers the tool handler by routing tool calls matching 'safari_get_network_logs' to the getNetworkLogs method in the main handleToolCall switch statement.
  case 'safari_get_network_logs': return await this.getNetworkLogs(args);
• src/safari-mcp-server.ts:317-328 (handler)

  MCP server handler: extracts sessionId from args, fetches network logs from SafariDriverManager, formats as JSON text response.
  private async getNetworkLogs(args: Record<string, any>): Promise<Array<{ type: string; text: string }>> { const { sessionId } = args; const logs = await this.driverManager.getNetworkLogs(sessionId); return [ { type: 'text', text: `Network Logs (${logs.length} entries):\n\n${JSON.stringify(logs, null, 2)}` } ]; }
• src/safari-driver.ts:170-278 (handler)

  Core implementation: injects JavaScript into the browser to capture network activity using PerformanceObserver for resources and fetch override for requests/responses, then retrieves and formats the logs.
  async getNetworkLogs(sessionId: string): Promise<NetworkLogEntry[]> { const session = this.getSession(sessionId); if (!session) { throw new Error(`Session ${sessionId} not found`); } try { // First, inject network monitoring if not already present await session.driver.executeScript(` if (!window.__safariMCPNetworkLogs) { window.__safariMCPNetworkLogs = []; // Capture existing performance entries const existingEntries = performance.getEntriesByType('resource'); existingEntries.forEach(entry => { window.__safariMCPNetworkLogs.push({ method: 'Network.resourceFinished', url: entry.name, status: null, // Not available from Resource Timing API requestHeaders: null, responseHeaders: null, timestamp: Date.now() - (performance.now() - entry.startTime), duration: entry.duration, transferSize: entry.transferSize || null, encodedBodySize: entry.encodedBodySize || null, decodedBodySize: entry.decodedBodySize || null }); }); // Monitor new resources using PerformanceObserver if ('PerformanceObserver' in window) { const observer = new PerformanceObserver((list) => { for (const entry of list.getEntries()) { if (entry.entryType === 'resource') { window.__safariMCPNetworkLogs.push({ method: 'Network.resourceFinished', url: entry.name, status: null, requestHeaders: null, responseHeaders: null, timestamp: Date.now() - (performance.now() - entry.startTime), duration: entry.duration, transferSize: entry.transferSize || null, encodedBodySize: entry.encodedBodySize || null, decodedBodySize: entry.decodedBodySize || null }); } } }); observer.observe({ entryTypes: ['resource'] }); } // Intercept fetch requests for additional data const originalFetch = window.fetch; window.fetch = function(...args) { const url = typeof args[0] === 'string' ? args[0] : args[0].url; const startTime = Date.now(); return originalFetch.apply(this, args).then(response => { window.__safariMCPNetworkLogs.push({ method: 'Network.responseReceived', url: url, status: response.status, requestHeaders: args[1]?.headers || null, responseHeaders: Object.fromEntries(response.headers.entries()), timestamp: startTime, duration: Date.now() - startTime }); return response; }).catch(error => { window.__safariMCPNetworkLogs.push({ method: 'Network.loadingFailed', url: url, status: null, requestHeaders: args[1]?.headers || null, responseHeaders: null, timestamp: startTime, duration: Date.now() - startTime, error: error.message }); throw error; }); }; } `); // Retrieve captured network logs const networkLogs = await session.driver.executeScript(` return window.__safariMCPNetworkLogs || []; `); return networkLogs.map((log: any) => ({ method: log.method, url: log.url, status: log.status, requestHeaders: log.requestHeaders, responseHeaders: log.responseHeaders, timestamp: log.timestamp, ...(log.duration !== undefined && { duration: log.duration }), ...(log.transferSize !== undefined && { transferSize: log.transferSize }), ...(log.encodedBodySize !== undefined && { encodedBodySize: log.encodedBodySize }), ...(log.decodedBodySize !== undefined && { decodedBodySize: log.decodedBodySize }), ...(log.error && { error: log.error }) })); } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : String(error); throw new Error(`Failed to get network logs: ${errorMessage}`); } }