Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@guhcostan/web-search-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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