BrowserTools MCP

Instructions

Implementation Reference

• browser-tools-mcp/mcp-server.ts:178-193 (handler)

  The handler function for the 'getConsoleLogs' MCP tool. It ensures a connection to the browser connector server using withServerConnection, fetches console logs from the '/console-logs' endpoint, parses the JSON response, and returns it formatted as MCP content.

  server.tool("getConsoleLogs", "Check our browser logs", async () => {
    return await withServerConnection(async () => {
      const response = await fetch(
        `http://${discoveredHost}:${discoveredPort}/console-logs`
      );
      const json = await response.json();
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(json, null, 2),
          },
        ],
      };
    });
  });

• browser-tools-mcp/mcp-server.ts:116-175 (helper)

  Helper function used by getConsoleLogs (and other tools) to ensure a reliable connection to the browser connector server, including automatic discovery and reconnection on failure.

  async function withServerConnection<T>(
    apiCall: () => Promise<T>
  ): Promise<T | any> {
    // Attempt to discover server if not already discovered
    if (!serverDiscovered) {
      const discovered = await discoverServer();
      if (!discovered) {
        return {
          content: [
            {
              type: "text",
              text: "Failed to discover browser connector server. Please ensure it's running.",
            },
          ],
          isError: true,
        };
      }
    }
  
    // Now make the actual API call with discovered host/port
    try {
      return await apiCall();
    } catch (error: any) {
      // If the request fails, try rediscovering the server once
      console.error(
        `API call failed: ${error.message}. Attempting rediscovery...`
      );
      serverDiscovered = false;
  
      if (await discoverServer()) {
        console.error("Rediscovery successful. Retrying API call...");
        try {
          // Retry the API call with the newly discovered connection
          return await apiCall();
        } catch (retryError: any) {
          console.error(`Retry failed: ${retryError.message}`);
          return {
            content: [
              {
                type: "text",
                text: `Error after reconnection attempt: ${retryError.message}`,
              },
            ],
            isError: true,
          };
        }
      } else {
        console.error("Rediscovery failed. Could not reconnect to server.");
        return {
          content: [
            {
              type: "text",
              text: `Failed to reconnect to server: ${error.message}`,
            },
          ],
          isError: true,
        };
      }
    }
  }

• browser-tools-mcp/mcp-server.ts:178-193 (registration)

  Registration of the 'getConsoleLogs' tool on the MCP server with description and inline handler function.

  server.tool("getConsoleLogs", "Check our browser logs", async () => {
    return await withServerConnection(async () => {
      const response = await fetch(
        `http://${discoveredHost}:${discoveredPort}/console-logs`
      );
      const json = await response.json();
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(json, null, 2),
          },
        ],
      };
    });
  });