fix: Browser persistence - singleton pattern + lifecycle tools

- Add browser singleton to persist across MCP tool calls
- Add reset_browser tool to create new browser instance
- Add close_browser tool for proper cleanup
- Add close() method to browser.py for resource cleanup
- Update CHANGELOG to v0.4.0

Author: browser-mcp

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-04-03
+
+### Added
+- Browser singleton pattern - browser persists across MCP tool calls
+- reset_browser tool - close current and create new browser instance
+- close_browser tool - properly cleanup browser resources
+
+### Fixed
+- Browser no longer closes between tool calls
+- Session state maintained across multiple navigations
+
 ## [0.3.0] - 2024-04-03
 
 ### Fixed

browser_mcp/browser.py

@@ -90,6 +90,13 @@ def set_size(self, width: int, height: int):
         self._window.resize(width, height)
         self._process_events(0.2)
 
+    def close(self):
+        """Close the browser and cleanup resources."""
+        try:
+            self._window.destroy()
+        except Exception:
+            pass
+
     def _on_load_changed(self, view, load_event):
         if load_event == WebKit.LoadEvent.FINISHED:
             self._ready.set()

browser_mcp/server.py

@@ -17,17 +17,36 @@
 
 server = Server("browser-mcp")
 
+_browser_instance = None
+
 
 def get_browser() -> "WebKitBrowser":
-    """Create and return a browser instance."""
+    """Get or create a persistent browser instance."""
+    global _browser_instance
+    
     if WebKitBrowser is None:
         raise ImportError(
             "WebKitGTK not available. Install with:\n"
             "  Ubuntu/Debian: sudo apt install libwebkit2gtk-4.1-dev python3-gi python3-gi-cairo gir1.2-webkit2-4.1\n"
             "  Fedora: sudo dnf install webkit2gtk4.1-devel pygobject3 cairo-gobject\n"
             "  Arch: sudo pacman -S webkit2gtk4.1 python-gobject python-cairo gobject-introspection"
         )
-    return WebKitBrowser()
+    
+    if _browser_instance is None:
+        _browser_instance = WebKitBrowser()
+    
+    return _browser_instance
+
+
+def reset_browser() -> None:
+    """Reset the browser instance - closes current and creates new one."""
+    global _browser_instance
+    if _browser_instance is not None:
+        try:
+            _browser_instance.close()
+        except Exception:
+            pass
+    _browser_instance = None
 
 
 @server.list_tools()
@@ -195,6 +214,16 @@ async def list_tools() -> list[Tool]:
             description="Get path to the last auto-screenshot",
             inputSchema={"type": "object", "properties": {}},
         ),
+        Tool(
+            name="reset_browser",
+            description="Reset browser - close current instance and create new one",
+            inputSchema={"type": "object", "properties": {}},
+        ),
+        Tool(
+            name="close_browser",
+            description="Close the browser and cleanup resources",
+            inputSchema={"type": "object", "properties": {}},
+        ),
     ]
 
 
@@ -315,6 +344,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent]:
                 return [TextContent(type="text", text=f"Screenshot: {path}")]
             return [TextContent(type="text", text="No screenshot available")]
 
+        elif name == "reset_browser":
+            reset_browser()
+            return [TextContent(type="text", text="Browser reset - new instance created")]
+
+        elif name == "close_browser":
+            reset_browser()
+            return [TextContent(type="text", text="Browser closed")]
+
         else:
             return [TextContent(type="text", text=f"Unknown tool: {name}")]