mcp-web-tools 0.7.8

A powerful MCP server to equip LLMs with web access, search, and content extraction capabilities

MCP Web Tools

This package provides a powerful MCP server to equip LLMs with web access, going beyond naive methods of searching, fetching and extracting content.

Introduction

I created this package out of the frustration that most MCP servers enabling web access to LLMs, didn't perform as well as I hoped. Some of these shortcomings I wanted fix, include:

• Good search results without requiring an API key
• Sophisticated fetching for more complex JavaScript sites
• Extracting content in nicely formatted Markdown
• Support for extracting content from PDFs
• Support for loading and displaying images
• Usage options for advanced cases like loading raw HTML

Installation

Claude Desktop

</code></pre>
<h3>Claude Code</h3>
<pre lang="bash"><code>claude mcp add web-tools uvx mcp-web-tools

Or to also set the Brave Search API key:

claude mcp add web-tools uvx mcp-web-tools -e BRAVE_SEARCH_API_KEY=<key>

Internals

The package is written in Python using powerful libraries and services under the hood to improve results.

Searching

We use the Brave Search API if an API key is provided with fallbacks a scraped Google workaround and finally DuckDuckGO if everything else fails. While we'd recommend getting a free Brave API key, the fallbacks should work more than well enough for most use cases and work loads.

Fetching

The fetching of web content is based on Zendriver, a fork of nodriver for next level webscraping and performance. It should stay undetected for most anti-bot solutions and fetch content even from complex JS-based sites.

Extracting

For web extraction, we use Trafilatura which consistently outperforms other alternatives for extracting content from HTML pages. For PDFs, we use PyMuPDF4LLM which similarly extracts content in an easy-to-read format for LLMs, with advanced layout support.

Contributing

While it's impossible to support all pages and layouts, we thrive to make this package better over time. For unsupported sites, problems, or feature requests open an issue.

CI, Releases, and Publishing

This repo includes a GitHub Actions workflow that:

• Runs tests via uv on PRs and pushes to main.
• On push to main, if project.version in pyproject.toml changed, it:
  • Builds distributions with uv build.
  • Creates a GitHub Release tagged v<version> with autogenerated notes.
  • Publishes the package to PyPI using uv publish.
• Merge a PR that bumps project.version in pyproject.toml to trigger a release.

Rollback:

• If a release was created erroneously, delete the GitHub Release and tag v<version>.
• Yank the version on PyPI if needed.