Safari MCP Server

Instructions

Implementation Reference

• src/safari-mcp-server.ts:115-125 (schema)

  Defines the tool schema for safari_clear_console_logs, specifying the input as an object requiring 'sessionId'.

  {
    name: 'safari_clear_console_logs',
    description: 'Clear captured console logs for a session',
    inputSchema: {
      type: 'object',
      properties: {
        sessionId: { type: 'string', description: 'Session identifier' }
      },
      required: ['sessionId']
    }
  },

• src/safari-mcp-server.ts:427-437 (handler)

  MCP tool handler that delegates to SafariDriverManager.clearConsoleLogs(sessionId) and returns a success message.

  private async clearConsoleLogs(args: Record<string, any>): Promise<Array<{ type: string; text: string }>> {
    const { sessionId } = args;
    
    await this.driverManager.clearConsoleLogs(sessionId);
    
    return [
      {
        type: 'text',
        text: `Console logs cleared for session '${sessionId}'`
      }
    ];

• src/safari-driver.ts:406-422 (handler)

  Executes JavaScript in the browser context to clear the __safariMCPConsoleLogs array, which captures console.log calls.

  async clearConsoleLogs(sessionId: string): Promise<void> {
    const session = this.getSession(sessionId);
    if (!session) {
      throw new Error(`Session ${sessionId} not found`);
    }
  
    try {
      await session.driver.executeScript(`
        if (window.__safariMCPConsoleLogs) {
          window.__safariMCPConsoleLogs = [];
        }
      `);
    } catch (error: unknown) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      throw new Error(`Failed to clear console logs: ${errorMessage}`);
    }
  }

• src/safari-mcp-server.ts:237-238 (registration)

  Switch case in handleToolCall that routes calls to the clearConsoleLogs handler.

  case 'safari_clear_console_logs':
    return await this.clearConsoleLogs(args);