Blazickjp Web Browser MCP Server

🚀 Web Browser MCP Server

Empower your AI applications with powerful web browsing capabilities! Enable your AI to read and understand web page content.

🚀 Quick Start

Installation

Choose your preferred package manager:

# Using pip
pip install web-browser-mcp-server

# Using uv (Recommended)
uv pip install web-browser-mcp-server

🔌 Claude Desktop Integration

Add this content to your Claude Desktop configuration file to unlock the powerful web browsing capabilities:

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

💡 Please replace /path/to/web-browser-mcp-server with your installation path.

✨ Features

• 🎯 Intelligent Content Extraction - Use CSS selectors to precisely locate the required content.
• ⚡ Lightning-Fast - High-performance implementation based on asynchronous processing.
• 📊 Rich Metadata - Capture titles, links, and structured content.
• 🛡️ Robust and Reliable - Built-in error handling and timeout management.
• 🌍 Cross-Platform Support - Works everywhere Python runs.

💻 Usage Examples

Precisely extract the required content from any web page:

Basic Usage

# Basic web scraping
result = browse_webpage(url="https://example.com")

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

⚙️ Configuration

Customize the behavior through environment variables:

🛠️ Development

Quickly set up your development environment:

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

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

# Run tests
python -m pytest

🤝 Contribution

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit pull requests

📄 License

MIT License - Use it freely! See LICENSE for details.