Web Browser MCP Server

🚀 Web Browser MCP Server

Enable AI assistants to browse and extract web content through a simple MCP interface.

Web Browser MCP Server allows AI models to browse websites, extract content, and understand web pages via the Message Control Protocol (MCP). It supports intelligent content extraction, uses CSS selectors to precisely locate targets, and provides powerful error handling capabilities.

✨ Features

• 🎯 Intelligent Content Extraction: Use CSS selectors to precisely locate the required content.
• ⚡ Fast and Efficient: Achieve optimal performance based on asynchronous processing.
• 📊 Rich Metadata: Capture titles, links, and structured content.
• 🛡️ Stable and Reliable: Built - in error handling and timeout management.
• 🌍 Cross - platform Support: Run on all platforms that support Python.

🚀 Quick Start

Installation via Smithery

Automatically install the Web Browser Server for Claude Desktop through Smithery:

npx -y @smithery/cli install web-browser-mcp-server --client claude

Manual Installation

Install using uv:

uv tool install web-browser-mcp-server

Development Environment Configuration

# Clone the repository and set up the development environment
git clone https://github.com/blazickjp/web-browser-mcp-server.git
cd web-browser-mcp-server

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install test dependencies
uv pip install -e ".[test]"

🔌 MCP Integration

Add the following configuration to your MCP client configuration file:

{
    "mcpServers": {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "web-browser-mcp-server"
            ],
            "env": {
                "REQUEST_TIMEOUT": "30"
            }
        }
    }
}

Development Environment Configuration

{
    "mcpServers": {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/web-browser-mcp-server",
                "run",
                "web-browser-mcp-server"
            ],
            "env": {
                "REQUEST_TIMEOUT": "30"
            }
        }
    }
}

📄 License

This project is released under the MIT License. See the LICENSE file for details.