MCP Web Search
MCP server: web search, Wikipedia summaries, and URL content extraction. No API keys required.
Features
- search_web - Two-tier web search (DuckDuckGo HTML / Puppeteer/Bing)
- fetch_url - Extract content with semantic truncation
- summarize_url - Fetch and summarize URL content
- wiki_get - Wikipedia summary by language
- wiki_multi - Wikipedia summaries in multiple languages
Requirements
- Node.js 18+
- Chrome/Chromium (for deep search mode)
MCP Configuration
Claude Code
{
"mcpServers": {
"web-search": {
"command": "npx",
"args": ["-y", "@zhafron/mcp-web-search"]
}
}
}
OpenCode
{
"mcp": {
"web-search": {
"type": "local",
"command": ["npx", "@zhafron/mcp-web-search"]
}
}
}
Generic / Others
{
"mcpServers": {
"web-search": {
"command": "npx",
"args": ["-y", "@zhafron/mcp-web-search"],
"env": {}
}
}
}
Chrome Setup
| OS | Command |
|---|---|
| Ubuntu/Debian | sudo apt install chromium-browser |
| Fedora | sudo dnf install chromium |
| Arch | sudo pacman -S chromium |
| macOS | brew install --cask google-chrome |
Custom path: export CHROME_PATH=/path/to/chrome
Environment Variables
| Variable | Default | Description |
|---|---|---|
| CHROME_PATH | auto-detect | Chrome executable path |
| HTTP_TIMEOUT | 15000 | Request timeout (ms) |
| USER_AGENT | mcp-web-search/1.1 | User agent string |
SSRF Protection: Blocks localhost, 127.0.0.1, ::1, .local domains.
Tools
search_web
Input: { q: string, limit?: number, lang?: string, mode?: "fast"|"deep"|"auto" }
Output: { items: Array<{ title, url, snippet?, source }>, modeUsed, enginesUsed, escalated }
fetch_url
Input: { url: string, mode?: "compact"|"standard"|"full", max_length?: number, format?: "markdown"|"text" }
| Mode | Characters | Tokens |
|---|---|---|
| compact | ~3000 | ~750 |
| standard | ~8000 | ~2000 |
| full | unlimited | - |
Output: { markdown?, text?, format, url, title?, truncated?, original_length? }
summarize_url
Input: { url: string }
wiki_get
Input: { title: string, lang?: string }
Output: { lang, title, url, description?, extract?, thumbnailUrl? }
wiki_multi
Input: { term: string, baseLang?: string, langs?: string[] }
Troubleshooting
| Issue | Solution |
|---|---|
| Chrome not found | Install Chrome or set CHROME_PATH |
| CAPTCHA/blocks | Reduce frequency, use fast mode |
| Timeout | Increase HTTP_TIMEOUT |
License
MIT