webread-mcp

# WebRead MCP A Model Context Protocol (MCP) server that enables AI assistants to read webpages and perform web searches. ## Tools ### read_webpage Fetches a webpage via GET request and returns its text content. **Parameters:** - `url` (required) - The URL to fetch - `max_chars` (optional, default: 500) - Maximum characters to return - `offset` (optional, default: 0) - Starting character position for chunked reading - `raw_html` (optional, default: false) - Return raw HTML instead of extracted text **Example:** ```json { "url": "https://example.com", "max_chars": 1000, "offset": 0 } ``` ### web_search Performs a web search using DuckDuckGo and returns titles with links. **Parameters:** - `query` (required) - The search query - `page` (optional, default: 1) - Page number (1-based) **Example:** ```json { "query": "python tutorial", "page": 1 } ``` ## Installation ### From PyPI ```bash pip install webread-mcp ``` ### From Source ```bash git clone <repository-url> cd webreadmcp pip install -e . ``` ## Configuration Add the server to your MCP client configuration: ### If installed via pip ```json { "mcpServers": { "webread": { "command": "python", "args": ["-m", "webread_mcp"] } } } ``` ## Running Manually ```bash python -m webread_mcp ``` The server communicates via stdio and will wait for MCP protocol messages. ### Custom CA Bundle ```json { "mcpServers": { "webread": { "command": "python", "args": ["-m", "webread_mcp"], "env": { "SSL_CERT_FILE": "/path/to/corporate-ca-bundle.crt" } } } } ``` ### Disable SSL Verification (Not Recommended) ```json { "mcpServers": { "webread": { "command": "python", "args": ["-m", "webread_mcp"], "env": { "WEBREAD_VERIFY_SSL": "false" } } } } ``` ## Dependencies - `mcp` - Model Context Protocol SDK - `httpx` - HTTP client - `beautifulsoup4` - HTML parsing - `duckduckgo_search` - Web search