mcp-server-local-web-search

一个用于执行本地网络搜索的 MCP 服务器。此服务器提供通过模型上下文协议搜索和提取网页内容的工具。

特性

• 执行具有可自定义结果限制的网络搜索
• 从网页提取和处理内容
• 返回包含标题、URL 和描述的结构化结果
• 支持内容截断和域名过滤
• 使用 Readability 进行干净的内容提取
• 无头浏览器操作，以提高性能

安装

要安装依赖项：

bun install

设置

运行设置脚本以配置 MCP 服务器：

bun run setup.ts

这会将服务器添加到您的 Claude MCP 配置中。

可用工具

1. local_web_search
   • 执行网络搜索并返回包含标题、URL 和描述的结果
   • 参数：
     • query: 用于查找相关内容的搜索查询（必需）
     • excludeDomains: 要从搜索结果中排除的域名列表（默认：[]）
     • limit: 要返回的最大结果数（默认：5）
     • truncate: 每个结果要返回的最大内容长度（默认：4000）
     • show: 显示浏览器窗口以进行调试（默认：false）
     • proxy: 用于请求的代理服务器（可选）

要求

• Bun 运行时
• Node.js TypeScript 支持

开发

本项目使用：

• Bun 作为 JavaScript 运行时
• TypeScript 用于类型安全
• 模型上下文协议 SDK 用于服务器实现
• @egoist/local-web-search 用于网络搜索（使用 playwright-core）
• Readability 用于内容提取

贡献者

• egoist - 原始本地网络搜索作者
• FradSer - 原始作者
• TheSethRose - Playwright 集成和性能改进

许可证

MIT 许可证

本项目是使用 bun v1.2.2 中的 bun init 创建的。Bun 是一个快速的一体化 JavaScript 运行时。