BrowserTools MCP

Instructions

Implementation Reference

• browser-tools-mcp/mcp-server.ts:234-249 (handler)

  The handler function for the 'getNetworkLogs' tool. It fetches network success logs from the discovered browser connector server at '/network-success' endpoint and returns the JSON response as formatted text.

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

• browser-tools-mcp/mcp-server.ts:234-249 (registration)

  Registers the 'getNetworkLogs' tool with MCP server using server.tool(), including description and inline handler implementation.

  server.tool("getNetworkLogs", "Check ALL our network logs", async () => {
    return await withServerConnection(async () => {
      const response = await fetch(
        `http://${discoveredHost}:${discoveredPort}/network-success`
      );
      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 'withServerConnection' used by the getNetworkLogs handler (and others) to ensure server discovery and handle reconnections before making API calls to the browser connector.

  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,
        };
      }
    }
  }