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

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)
     • limit: Maximum number of results to return (default: 10)

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
• Readability for content extraction

License

MIT License

This project was created using bun init in bun v1.2.2. Bun is a fast all-in-one JavaScript runtime.