Metadata-Version: 2.4
Name: web-browser-mcp-server
Version: 0.2.1
Summary: Transform your AI applications with advanced web browsing capabilities through this Model Context Protocol (MCP) server
Project-URL: Repository, https://github.com/blazickjp/web-browser-mcp-server
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: aiohttp==3.9.1
Requires-Dist: beautifulsoup4==4.12.2
Requires-Dist: click==8.1.7
Requires-Dist: fastapi>=0.110.0
Requires-Dist: mcp>=1.1.2
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: python-dotenv==1.0.0
Requires-Dist: requests==2.31.0
Requires-Dist: uvicorn==0.27.0
Provides-Extra: test
Requires-Dist: aioresponses==0.7.6; extra == 'test'
Requires-Dist: httpx>=0.27.0; extra == 'test'
Requires-Dist: pluggy==1.3.0; extra == 'test'
Requires-Dist: pytest-asyncio==0.23.5; extra == 'test'
Requires-Dist: pytest-cov==4.1.0; extra == 'test'
Requires-Dist: pytest==8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# 🌐 Web Browser MCP Server

[![smithery badge](https://smithery.ai/badge/web-browser-mcp-server)](https://smithery.ai/server/web-browser-mcp-server)
[![PyPI version](https://badge.fury.io/py/web-browser-mcp-server.svg)](https://badge.fury.io/py/web-browser-mcp-server)
[![Tests](https://github.com/blazickjp/web-browser-mcp-server/actions/workflows/tests.yml/badge.svg)](https://github.com/blazickjp/web-browser-mcp-server/actions/workflows/tests.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/web-browser-mcp-server.svg)](https://badge.fury.io/py/web-browser-mcp-server)
[![PyPI downloads](https://img.shields.io/pypi/dm/web-browser-mcp-server.svg)](https://pypi.org/project/web-browser-mcp-server/)
> 🤖 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

#### Installing via Smithery

To install Web Browser MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/web-browser-mcp-server):

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

Choose your favorite package manager:

```bash
# 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>

```json
{
    "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:

```python
# 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"
    }
)
```


## 🛠️ Development

Set up your dev environment in seconds:

```bash
# 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](LICENSE) for details.

---

<div align="center">

### 🌟 Level Up Your AI with Web Browsing Powers! 🌟

Built for the [Model Context Protocol](https://github.com/anthropics/anthropic-tools) | Made with ❤️ by Pearl Labs

<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>
