mcp-server-local-web-search

🚀 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 License。该项目使用 bun init 创建，版本为 bun v1.2.2。Bun 是一个快速的全功能 JavaScript 运行时。