web-browser-mcp-server

GitHub
  • Browser Automation
Python
MIT
2
-
security - not tested
A
license - permissive license (MIT)
-
quality - not tested

Enables web browsing capabilities using BeautifulSoup4

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoLogging verbosityinfo
USER_AGENTNoCustom user agent stringModern Chrome UA
MAX_RETRIESNoMax retry attempts3
REQUEST_TIMEOUTNoMax request time in seconds30
Need Help?View Source CodeReport Issue
README.md

🌐 Web Browser MCP Server

PyPI version License: MIT Python Code style: black

🤖 Transform your AI applications with powerful web browsing capabilities! Let your AI read and understand the web.

✨ 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

Installation

Choose your favorite 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 to your Claude Desktop config to unlock web browsing superpowers:

<details> <summary>📝 Click to view configuration</summary>
{ "mcpServers": { "web-browser-mcp-server": { "command": "uv", "args": [ "--directory", "/path/to/web-browser-mcp-server", "run", "web-browser-mcp-server" ], "env": { "REQUEST_TIMEOUT": "30" } } } }
</details>

💡 Replace /path/to/web-browser-mcp-server with your installation path

🎮 Usage Examples

Extract exactly what you need from any webpage:

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

⚙️ Configuration

Customize behavior with environment variables:

VariableDescriptionDefault
REQUEST_TIMEOUT⏱️ Max request time (seconds)30
USER_AGENT🕵️ Custom user agent stringModern Chrome UA
LOG_LEVEL📝 Logging verbosity"info"
MAX_RETRIES🔄 Max retry attempts3

🛠️ Development

Set up your dev environment in seconds:

# Create and activate virtual environment uv venv source .venv/bin/activate # Install dev dependencies uv pip install -e ".[test]" # Run tests python -m pytest

🤝 Contributing

Contributions are welcome! Feel free to:

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

📜 License

MIT License - do what you want! See LICENSE for details.

<div align="center">

🌟 Level Up Your AI with Web Browsing Powers! 🌟

Built for the Model Context Protocol | Made with ❤️ by the MCP Community

<details> <summary>🎉 Star us on GitHub!</summary> <br> If you find this tool useful, consider giving it a star! It helps others discover the project. </details> </div>

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • mcp-server-browserbase

    -
    security
    F
    license
    -
    quality
    This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.

  • mcp-webresearch

    -
    security
    A
    license
    -
    quality
    A Model Context Protocol (MCP) server for web research. Bring real-time info into Claude and easily research any topic.
    MIT
    • Apple

  • nyt

    A
    security
    A
    license
    A
    quality
    This is a TypeScript-based MCP server that allows searching for New York Times articles from the last 30 days based on a keyword.
    MIT
    • Apple

  • servers

    A
    security
    A
    license
    A
    quality
    An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
    MIT