Web BrowserSAFE

An advanced web browsing server for the Model Context Protocol (MCP) powered by Playwright, enabling headless browser interactions through a flexible, secure API.

🌐 Features

• Headless Web Browsing: Navigate to any website with SSL certificate validation bypass
• Full Page Content Extraction: Retrieve complete HTML content, including dynamically loaded JavaScript
• Multi-Tab Support: Create, manage, and switch between multiple browser tabs
• Advanced Web Interaction Tools:
• Extract text content
• Click page elements
• Input text into form fields
• Capture screenshots
• Extract page links with filtering capabilities
• Scroll pages in any direction
• Execute JavaScript on pages
• Refresh pages
• Wait for navigation to complete
• Resource Management: Automatic cleanup of unused resources after inactivity
• Enhanced Page Information: Get detailed metadata about the current page

🚀 Quick Start

Prerequisites

• Python 3.10+
• MCP SDK
• Playwright

Installation

# Install MCP and Playwright
pip install mcp playwright

# Install browser dependencies
playwright install

Configuration for Claude Desktop

Add to your claude_desktop_config.json:

{
"mcpServers": {
"web-browser": {
"command": "python",
"args": [
"/path/to/your/server.py"
]
}
}
}

💡 Usage Examples

Basic Web Navigation

# Browse to a website
page_content = browse_to("https://example.com")

# Extract page text
text_content = extract_text_content()

# Extract text from a specific element
title_text = extract_text_content("h1.title")

Web Interaction

# Navigate to a page
browse_to("https://example.com/login")

# Input text into a form
input_text("#username"