Metadata-Version: 2.3
Name: web-browser-mcp
Version: 0.1.0
Summary: A Minimum Control Program (MCP) server for web browsing capabilities using BeautifulSoup4
Requires-Dist: aiohttp==3.9.1
Requires-Dist: beautifulsoup4==4.12.2
Requires-Dist: click==8.1.7
Requires-Dist: fastapi==0.109.0
Requires-Dist: pydantic-settings==2.1.0
Requires-Dist: pydantic==2.6.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: httpx==0.26.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

This Model Context Protocol (MCP) server provides web browsing capabilities with BeautifulSoup4, enabling structured data extraction and web page parsing. The server is designed to integrate seamlessly with Claude and other MCP-compatible applications.

## Integration with Claude Desktop

To use this server with Claude Desktop, add the following configuration to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "web-browser": {
      "module": "web-browser-mcp",
      "env": {
        "REQUEST_TIMEOUT": "30"
      }
    }
  }
}
```

## Configuration Options

The server accepts several environment variables for customization:

```ini
REQUEST_TIMEOUT=30
USER_AGENT=Your custom user agent string
MAX_RETRIES=3
PORT=8000
HOST=0.0.0.0
```

## Development and Testing

For local development, create a virtual environment and install dependencies:

```bash
uv venv
source .venv/bin/activate
uv pip install -e ".[test]"
```

Run the test suite:

```bash
python -m pytest
```

## License

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