MCP Local Web Search Server
Enables performing local web searches and extracting structured content from web pages using the Model Context Protocol, featuring customizable result limits and domain filtering.
FradSer
README
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:
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
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Playwright MCP Server
Provides a server utilizing Model Context Protocol to enable human-like browser automation with Playwright, allowing control over browser actions such as navigation, element interaction, and scrolling.
@kazuph/mcp-fetch
Model Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Apple MCP Server
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
DuckDuckGo MCP Server
A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
contentful-mcp
Update, create, delete content, content-models and assets in your Contentful Space
YouTube Transcript MCP Server
This server retrieves transcripts for given YouTube video URLs, enabling integration with Goose CLI or Goose Desktop for transcript extraction and processing.
serper-search-scrape-mcp-server
This Serper MCP Server supports search and webpage scraping, and all the most recent parameters introduced by the Serper API, like location.