mcp-server-local-web-search

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

Related MCP server: DuckDuckGo MCP Server

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:

• Bun as the JavaScript runtime

• TypeScript for type safety

• Model Context Protocol SDK for server implementation

• @egoist/local-web-search for web search (using playwright-core)

• Readability for content extraction

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.