Web Search MCP

A comprehensive, production-ready research server for the Model Context Protocol (MCP). Provide your LLM clients with real-time access to the web, weather data, and more.

✨ Features

🌐 Deep Web Search: Text and news search via DuckDuckGo.
📄 Content Extraction: Read clutter-free full text from any URL using trafilatura. Supports multiple output formats (text, markdown, JSON), metadata extraction, and content filtering.
💻 Technical Docs: Targeted search for developer documentation (Python, React, etc.).
🌤️ Weather Data: Current conditions and forecasts via OpenMeteo.
📍 Geocoding: Convert location names/addresses to geographic coordinates using OpenStreetMap (Nominatim).

🚀 Quick Start

Installation

Install directly using uv:

uv tool install git+https://github.com/sydasif/web-search-mcp.git

Configuration

Add the server to your MCP client configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "web-search": {
      "command": "web-search-mcp"
    }
  }
}

🛠️ Tool Reference

Tool	Description	Key Parameters
`search_web`	Universal search (Web, News)	`query`, `search_type` ("text", "news"), `max_results`, `time_range`, `region`, `filters`
`fetch_page`	Extract clean article text from a URL	`url`, `output_format` ("csv", "html", "json", "markdown", "python", "txt", "xml", "xmltei"), `include_metadata`, `include_tables`, `include_comments`, `include_images`, `max_length`, `timeout`
`search_docs`	Search specific tech documentation or domains	`query`, `domain` (e.g., "docs.python.org", "github.com")
`get_weather`	Current conditions or forecast (defaults to current)	`latitude`, `longitude`, `mode` ("current"/"forecast"), `days`
`get_location`	Convert location names/addresses to geographic coordinates	`query`, `limit` (max number of results)

💻 Development

Click to expand development instructions

Clone the repository

git clone https://github.com/sydasif/web-search-mcp.git
cd web-search-mcp

Sync dependencies
```
uv sync
```

Run tests

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=web_search_mcp

Linting & Formatting
```
uv run ruff check .
```

📄 License

This project is licensed under the MIT License.