Overview
What is mcp-server-local-web-search?
An MCP server for performing local web searches, designed to search and extract content from web pages through the Model Context Protocol. It is intended for developers who need to integrate web search and content retrieval directly into Claude or other MCP clients.
How to use mcp-server-local-web-search?
Install dependencies with bun install, then run bun run setup.ts to configure the MCP server in your Claude MCP configuration. Once set up, use the local_web_search tool with parameters such as query (required), excludeDomains, limit, truncate, show, and proxy.
Key features of mcp-server-local-web-search
- Perform web searches with customizable result limits.
- Extract and process content from web pages.
- Return structured results with titles, URLs, and descriptions.
- Support content truncation and domain filtering.
- Clean content extraction using Readability.
- Headless browser operation for improved performance.
Use cases of mcp-server-local-web-search
- Search for current information directly from a Claude conversation.
- Extract and summarize article content from a list of URLs.
- Filter out unwanted domains from search results.
- Retrieve a small set of top results for quick answers.
FAQ from mcp-server-local-web-search
What runtime and dependencies are required?
The server requires the Bun runtime and Node.js TypeScript support. Key dependencies include the Model Context Protocol SDK, @egoist/local-web-search (using playwright-core), and Mozilla’s Readability.
Can I filter out certain domains from search results?
Yes, use the excludeDomains parameter to provide a list of domains to exclude from the results.
How many search results can I get, and can I control content length?
The default result limit is 5, configurable via the limit parameter. The truncate parameter sets the maximum character length per result (default 4000).
Does the server support using a proxy?
Yes, an optional proxy parameter is available for requests.
Can I see the browser window during operation?
By default the browser runs headless. Set show: true to display the browser window for debugging purposes.
