mcp-server-local-web-search
The mcp-server-local-web-search is a JavaScript-based tool designed for efficient web searching in local environments. It allows users to quickly search for information based on specified criteria and presents the results in an organized manner. This tool is particularly beneficial for developers and data analysts, as it significantly enhances workflow efficiency.
GitHub Stars
8
User Rating
Not Rated
Forks
0
Issues
1
Views
3
Favorites
0
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.