mcpField
M
mcp-server-local-web-search

mcp-server-local-web-search

Local
github.com/FradSerSearch10Updated 79w ago
Repository

About mcp-server-local-web-search

mcp-server-local-web-search is an MCP server for local web search and page-content extraction. It returns structured search results and provides controls for result limits, domain exclusion, and content length.

Key features

  1. 01Search the web with configurable result limits
  2. 02Extract and process web page content
  3. 03Return titles, URLs, and descriptions
  4. 04Filter domains and truncate content
  5. 05Extract readable content with Readability
  6. 06Use a headless browser

Use cases

  1. 01Finding web pages while excluding selected domains
  2. 02Retrieving readable content from search results
  3. 03Limiting result count or extracted text length

MCP support

The server exposes a local_web_search tool through MCP. MCP clients can provide a query, excluded domains, result limit, truncation length, and optional proxy.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-server-local-web-search

README image Twitter Follow

An MCP server for performing local web searches. This server provides tools to search and extract content from web pages through the Model Context Protocol.

Features

  • Perform web searches with customizable result limits
  • Extract and process content from web pages
  • Return structured results with titles, URLs, and descriptions
  • Support for content truncation and domain filtering
  • Clean content extraction using Readability
  • Headless browser operation for improved performance

Installation

To install dependencies:

bun install

Setup

Run the setup script to configure the MCP server:

bun run setup.ts

This will add the server to your Claude MCP configuration.

Available Tools
  1. local_web_search
    • Performs web search and returns results with title, URL and description
    • Parameters:
      • query: Search query to find relevant content (required)
      • excludeDomains: List of domains to exclude from search results (default: [])
      • limit: Maximum number of results to return (default: 5)
      • truncate: Maximum length of content to return per result (default: 4000)
      • show: Show browser window for debugging (default: false)
      • proxy: Proxy server to use for requests (optional)

Requirements

  • Bun runtime
  • Node.js TypeScript support

Development

This project uses:

Contributors

  • egoist - Original local web search author
  • FradSer - Original author
  • TheSethRose - Playwright integration and performance improvements

License

MIT License

This project was created using bun init in bun v1.2.2. Bun is a fast all-in-one JavaScript runtime.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.