mcp-server-local-web-search

@FradSer

About mcp-server-local-web-search

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-local-web-search": {
      "command": "bun",
      "args": [
        "run",
        "setup.ts"
      ]
    }
  }
}

Tools

`query`: Search query to find relevant content (required)

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.

Frequently asked questions

What runtime and dependencies are required?

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.

Comments

Basic information

More Search MCP servers

Brave Search MCP Server

mikechao

An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities

121