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
Installation
To install dependencies:
Setup
Run the setup script to configure the MCP server:
This will add the server to your Claude MCP configuration.
Available Tools
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.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables performing local web searches and extracting structured content from web pages using the Model Context Protocol, featuring customizable result limits and domain filtering.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityProvides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.Last updated -21,15135JavaScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.Last updated -241JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables web search with category support, website content scraping with citation metadata, and timezone-aware date/time tools.Last updated -9PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that intelligently fetches and processes web content, transforming websites and documentation into clean, structured markdown with nested URL crawling capabilities.Last updated -5521TypeScript