Local Web Search

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:

• 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.