mcp-server-local-web-search
Overview
The mcp-server-local-web-search is a server designed to perform local web searches using the Model Context Protocol, allowing users to search and extract content from web pages efficiently.
To use the server, install the necessary dependencies with bun install, then run the setup script with bun run setup.ts to configure the server. You can perform searches using the local_web_search tool by providing a search query and an optional limit on the number of results.
- Customizable result limits for web searches - Content extraction and processing from web pages - Structured results including titles, URLs, and descriptions - Support for content truncation and domain filtering - Clean content extraction using Readability
- Searching for specific information on the web and extracting relevant content.
- Filtering search results based on domains to focus on specific sources.
- Integrating with other applications to provide web search capabilities.
Add to your AI client
Use these steps to connect mcp-server-local-web-search in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-local-web-search-fradser": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-local-web-search-fradser": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-local-web-search-fradser": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-local-web-search-fradser": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-local-web-search-fradser": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-local-web-search-fradser": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-local-web-search-fradser"
]
}
}
}FAQ
What is the Model Context Protocol?
The Model Context Protocol is a framework that allows for structured communication between different components in a system, facilitating tasks like web searches.
Is there a limit to the number of search results?
Yes, you can set a limit on the number of results returned by the search query.
What technologies does this project use?
The project uses Bun as the JavaScript runtime, TypeScript for type safety, and various libraries for web search and content extraction.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1348,"uuid":"e45e72b4-a2a7-42ad-beac-0e70c33d9f80","name":"mcp-server-local-web-search","title":"mcp-server-local-web-search","description":"","avatar_url":"https://avatars.githubusercontent.com/u/1439628?v=4","created_at":"2025-02-20T15:28:25.837Z","updated_at":"2025-02-23T07:21:17.718Z","status":"created","author_name":"FradSer","author_avatar_url":"https://avatars.githubusercontent.com/u/1439628?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/FradSer/mcp-server-local-web-search","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/5c60b16931474fe6b97a0f48c78b9387e66ae8d15e6a4cd2628724e83f6d2edd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f412532304652414425323050524f445543542d5749502d79656c6c6f77","type":null,"metadata":"{\"star\":\"5\",\"license\":\"MIT license\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-04-21 15:50:02\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]