Web Search MCP
Minimal MCP server that can search the web and extract readable page content, similar to Cursor's built-in web context.
Features
- search_web: Query the web (DuckDuckGo HTML) and return result URLs and titles
- fetch_page: Fetch any URL and extract readable content using Mozilla Readability + JSDOM
Requirements
- Node.js 20+ (recommended: 20.18.1+)
Install
npm install
Run (stdio)
npm start
Install globally
npm i -g @guhcostan/web-search-mcp
Then reference the binary web-search-mcp.
Integrate with Cursor (MCP)
Add to your Cursor MCP settings:
{
"mcpServers": {
"web-search-mcp": { "command": "web-search-mcp" }
}
}
Alternatively, without global install, use npx:
{
"mcpServers": {
"web-search-mcp": {
"command": "npx",
"args": ["-y", "@guhcostan/web-search-mcp@latest"]
}
}
}
Tools
-
search_web
- input:
query(string, required)limit(number, optional, 1–10, default 5)
- output: array of
{ url: string; title?: string; snippet?: string }
- input:
-
fetch_page
- input:
url(string URL, required)
- output:
{ url: string; title?: string; content: string }
- input:
Development
Type-check, lint and tests:
npm run check
Run individually:
npm run build
npm run lint
npm test
Notes
- Web search uses DuckDuckGo HTML; results may vary and are HTML-scraped (no API key required)
- Be mindful of target site terms of use and robots policies when fetching pages
License
MIT
