web-browser-mcp-server

✨ Features

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

The Web Browser MCP Server provides AI models with the ability to browse websites, extract content, and understand web pages through the Message Control Protocol (MCP). It enables smart content extraction with CSS selectors and robust error handling.

🤝 Contribute • 📝 Report Bug

✨ Core Features

🎯 Smart Content Extraction: Target exactly what you need with CSS selectors
⚡ Lightning Fast: Built with async processing for optimal performance
📊 Rich Metadata: Capture titles, links, and structured content
🛡️ Robust & Reliable: Built-in error handling and timeout management
🌍 Cross-Platform: Works everywhere Python runs

🚀 Quick Start

Installing via Smithery

To install Web Browser Server for Claude Desktop automatically via Smithery:

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

Installing Manually

Install using uv:

uv tool install web-browser-mcp-server

For development:

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

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

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

🔌 MCP Integration

Add this configuration to your MCP client config file:

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

For Development:

{
    "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"
            }
        }
    }
}

💡 Available Tools

The server provides a powerful web browsing tool:

browse_webpage

Browse and extract content from web pages with optional CSS selectors:

# Basic webpage fetch
result = await call_tool("browse_webpage", {
    "url": "https://example.com"
})

# Target specific content with CSS selectors
result = await call_tool("browse_webpage", {
    "url": "https://example.com",
    "selectors": {
        "headlines": "h1, h2",
        "main_content": "article.content",
        "navigation": "nav a"
    }
})

⚙️ Configuration

Configure through environment variables:

Variable	Purpose	Default
`REQUEST_TIMEOUT`	Webpage request timeout in seconds	30

🧪 Testing

Run the test suite:

python -m pytest

📄 License

Released under the MIT License. See the LICENSE file for details.

Made with ❤️ by the Pear Labs Team

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

browse_webpage

Enables web browsing capabilities using BeautifulSoup4

Related MCP Servers

MCP Web Browser Server
random-robbie
A
security
A
license
A
quality
An advanced web browsing server enabling headless browser interactions via a secure API, providing features like navigation, content extraction, element interaction, and screenshot capture.
Last updated -
6
9
Python
MIT License
Fetch MCP Server
zcaceres
A
security
A
license
A
quality
Provides functionality to fetch web content in various formats, including HTML, JSON, plain text, and Markdown.
Last updated -
4
125,855
353
TypeScript
MIT License
Browser Use Server
ztobs
A
security
F
license
A
quality
Enables browser automation using Python scripts, offering operations like taking webpage screenshots, retrieving HTML content, and executing JavaScript.
Last updated -
4
18
Python
Puppeteer MCP Server
merajmehrabi
A
security
A
license
A
quality
Enables browser automation with Puppeteer, supporting navigation, form interactions, and connection to active Chrome instances for comprehensive web page interaction.
Last updated -
8
470
8
TypeScript
MIT License

View all related MCP servers

web-browser-mcp-server

✨ Features

✨ Core Features

🚀 Quick Start

Installing via Smithery

Installing Manually

🔌 MCP Integration

💡 Available Tools

browse_webpage

⚙️ Configuration

🧪 Testing

📄 License

Tools

Related MCP Servers

MCP Web Browser Server

Fetch MCP Server

Browser Use Server

Puppeteer MCP Server

Appeared in Searches

New MCP Servers

MCP directory API