Enables web searching via DuckDuckGo to retrieve formatted search results including titles, URLs, and content snippets.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Web Toolssearch for 'how to build an MCP server' and fetch the first link"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Web Tools
A Model Context Protocol (MCP) server that provides web search and fetch capabilities for AI assistants like Claude Code.
This is useful when you want your code-generation tool to make web requests directly from your machine, rather than having those requests proxied through an external server you don't control. The MCP server runs locally on your host, so all web requests originate from your own network.
Features
web_search - Search the web using DuckDuckGo
Returns formatted results with titles, URLs, and snippets
Configurable result count and region
web_fetch - Fetch and extract content from web pages
Automatic HTML-to-text conversion (removes scripts, styles, navigation)
JSON response formatting
Configurable timeout
Requirements
Python 3.13+
Installation
Quick Install (Recommended)
This will:
Install
mcp-web-toolsas a global executable viauv tool installRegister the MCP server with Claude Code using
claude mcp addThe executable will be available at
~/.local/bin/mcp-web-tools
Restart Claude Code after installation.
Manual Installation
Makefile Targets
Target | Description |
| Install globally and configure Claude Code |
| Remove the global installation |
| Run tests with pytest |
| Remove build artifacts |
Claude Code Configuration
After running make install, you can verify the registration:
The tools will be available in Claude Code as:
mcp__web-tools__web_searchmcp__web-tools__web_fetch
Manual Registration
If you prefer to register manually:
Alternative: Run from Project Directory
For development, you can register to run directly from the source:
Tool Reference
web_search
Search the web using DuckDuckGo.
Parameters:
Parameter | Type | Required | Default | Description |
query | string | Yes | - | The search query |
max_results | integer | No | 10 | Maximum number of results |
region | string | No | "wt-wt" | Region for results (e.g., "us-en", "uk-en") |
Example response:
web_fetch
Fetch the content of a web page.
Parameters:
Parameter | Type | Required | Default | Description |
url | string | Yes | - | The URL to fetch |
timeout | integer | No | 30 | Request timeout in seconds |
Example response:
Development
Running Tests
Project Structure
Dependencies
mcp - Model Context Protocol SDK
ddgs - DuckDuckGo Search API
httpx - Async HTTP client
lxml - HTML parsing (optional; falls back to regex-based extraction if not installed)
License
MIT