Skip to main content

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

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_web_tools-0.7.1.tar.gz (57.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_web_tools-0.7.1-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file mcp_web_tools-0.7.1.tar.gz.

File metadata

  • Download URL: mcp_web_tools-0.7.1.tar.gz
  • Upload date:
  • Size: 57.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.8

File hashes

Hashes for mcp_web_tools-0.7.1.tar.gz
Algorithm Hash digest
SHA256 b4addfc042ab3963fcd91180414003276b2dafb7b97c50d5d2f6406487ce0f13
MD5 2a8da662d9a06af5d032d66d8e9c50ba
BLAKE2b-256 57e42ae1cca8c015090800d4ff6cebb03fe269685dff5d7d3cf23a05b40f1865

See more details on using hashes here.

File details

Details for the file mcp_web_tools-0.7.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_web_tools-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5c1566f6c8b6096399d99064fa6d036e3a2eeb27f7833820fc73245c3c494c93
MD5 e0018aa309bf23b9991b6efdd5dc5dd3
BLAKE2b-256 06b73d749dd7271379d1b8ceb89952cea348225ac61150338698e4a3a2d78be8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page