MCP Web Search

A Model Context Protocol (MCP) server for web search using DuckDuckGo. No API key required.

Features

• Web Search - Search the web via DuckDuckGo's static HTML interface
• Content Extraction - Fetch and extract readable content from any webpage using Mozilla's Readability
• Zero Configuration - No API keys, no signup, works out of the box
• Lightweight - Uses Node.js native fetch, no heavy browser automation

Tools

Tool	Description
webSearch	Search the web with DuckDuckGo. Returns title, URL, and snippet for each result.
fetchWebContent	Extract main text content from a webpage URL. Removes ads, navigation, and noise.

Usage

Local installation

git clone https://github.com/doranobik/mcp-web-search.git
cd mcp-web-search
npm install
npm run build
node dist/index.js

Note: This package is not published to npm. The mcp-web-search name on npm belongs to an unrelated project, so install from this repository instead.

Docker

docker build -t mcp-web-search .
docker run -i mcp-web-search

MCP Client Configuration

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/mcp-web-search/dist/index.js"]
    }
  }
}

LM Studio (mcp.json):

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/mcp-web-search/dist/index.js"]
    }
  }
}

Tool Parameters

webSearch

Parameter	Type	Required	Default	Description
query	string	Yes	-	Search query
maxResults	number	No	10	Max results (1-20)
region	string	No	-	Region code (e.g., jp-ja, us-en, wt-wt)

fetchWebContent

Parameter	Type	Required	Default	Description
url	string	Yes	-	URL to fetch
maxChars	number	No	5000	Max characters to return (100-200000)

Disclaimer

This server searches the web by parsing DuckDuckGo's HTML interface, not an official API. It may break if DuckDuckGo changes its markup, and heavy automated use may violate DuckDuckGo's terms of service or lead to rate limiting. Use it responsibly and at your own risk.

License

MIT — see LICENSE for details.