← 返回目录

Web Search MCP Server

社区

为本地大语言模型提供多引擎网页搜索与内容提取能力

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 150 / 230
Stars: ★ 1.2k 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 14 个月前 ⚠
工具数: 3

50FMRS · D

该服务器功能丰富，支持多引擎搜索和完整内容提取，但依赖 Playwright 浏览器，需要一定资源。与 LM Studio 和 LibreChat 兼容性好，与较新模型配合效果最佳。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

13/20

文档质量

12/20

安装易用性

8/20

查看各项评分依据

可靠性 7/20: 代码库提供了清晰的工具定义（full-web-search, get-web-search-summaries, get-single-web-page-content），并包含错误处理（如HTTP/2回退）和超时保护。然而，由于这是静态审查且未执行代码，无法验证实际行为；没有提交的测试来覆盖关键路径（如搜索、内容提取）。因此，可靠性分数低于12。
安全与权限 10/20: 服务器通过环境变量配置，不处理持久化凭证；它进行外部网络请求并下载网页内容，这是预期的行为。存在潜在风险（如内容提取可能解析恶意HTML），但没有发现恶意行为或过度权限。没有安装示例包含真实令牌。由于缺乏对输入验证和资源限制的详细审查，分数被限制在10。
维护活跃度 13/20: 仓库活跃，有1072颗星，未归档，且有36个开放问题。提供了MIT许可证。有发布页面，但未提供提交频率或问题响应时间的证据。因此，维护分数为13。
文档质量 12/20: README非常详细，涵盖了功能、安装、配置、环境变量、故障排除和示例。存在API.md的引用，但未提供其内容。文档清晰，但有隐藏假设（如兼容性仅针对LM Studio和LibreChat）。因此，分数为12。
安装易用性 8/20: 安装步骤明确：需要Node.js 18+，npm install，npx playwright install，npm run build。提供了客户端配置示例（mcp.json，LibreChat）。然而，依赖Playwright浏览器安装，并且有手动步骤和潜在的网络要求。由于没有执行测试，安装分数限制在15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

使用 LM Studio 或 LibreChat 的本地 LLM 用户
需要联网搜索但不想使用 API 密钥的开发者
使用支持工具调用的较新模型（如 Qwen3、Gemma 3）

不适合谁

需要 API 密钥或稳定专有搜索服务的场景
使用旧版 Llama 或 Deepseek 且工具调用不稳定的模型
对响应速度要求极高且无法容忍浏览器开销的环境

所需权限

本地文件系统读取：运行 node 和 npm 命令
网络访问：搜索网页和访问搜索结果
浏览器自动化：下载和运行 Playwright 浏览器

风险与副作用

需要下载浏览器二进制文件，可能带来安全风险
网页内容可能包含恶意脚本，但提取时会处理
搜索依赖第三方搜索引擎，可能受网络限制或返回不稳定结果

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（10 个）

MAX_CONTENT_LENGTH 可选限制返回内容的最大字符数（默认 500000），可在 mcp. 的 env 中设置以解决内容过长导致的异常。

DEFAULT_TIMEOUT 可选请求超时时间（毫秒，默认 6000），可调低加快响应。

MAX_BROWSERS 可选维护的最大浏览器实例数（默认 3），调低可减少内存占用。

BROWSER_TYPES 可选使用的浏览器类型列表，默认 'chromium,firefox'，可选 chromium、firefox、webkit。

BROWSER_FALLBACK_THRESHOLD 可选 axios 失败多少次后回退到浏览器（默认 3）。

ENABLE_RELEVANCE_CHECKING 可选是否启用搜索结果质量校验（默认 true）。

RELEVANCE_THRESHOLD 可选搜索结果最低质量分数（0.0-1.0，默认 0.3）。

FORCE_MULTI_ENGINE_SEARCH 可选是否尝试所有搜索引擎并返回最佳结果（默认 false）。

DEBUG_BROWSER_LIFECYCLE 可选是否启用浏览器生命周期详细日志（默认 false）。

BROWSER_HEADLESS 可选是否使用无头模式，服务器环境应设为 true（默认）。

从 GitHub Releases 下载最新 zip 文件并解压。
在解压目录中运行 npm install、npx playwright install 和 npm run build。
在 mcp.json 中配置指向 dist/index.js 的路径。

MCP 配置 · JSON

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": [
        "/path/to/web-search-mcp/dist/index.js"
      ]
    }
  }
}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "web-search": {
      "command": "node",
      "args": [
        "/path/to/web-search-mcp/dist/index.js"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add web-search -- node /path/to/web-search-mcp/dist/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 LM Studio 或 LibreChat 的 MCP 工具列表中确认出现 full-web-search、get-web-search-summaries 和 get-single-web-page-content 三个工具；然后输入一个搜索请求，若能返回结果即证明安装成功。

常见排障

如果 npm install 失败，请升级 Node.js 和 npm
如果 search 失败，请运行 `npx playwright install` 安装浏览器
如果响应缓慢，可设置环境变量如 DEFAULT_TIMEOUT=4000、MAX_BROWSERS=1
如果内容截断，可设置 MAX_CONTENT_LENGTH 环境变量

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 full-web-search 搜索 "TypeScript MCP server"，返回 3 条结果并抓取全文内容
帮我搜索最新本地大模型工具调用方面的文章，只要摘要就行
抓取 https://example.com/article 这个页面的正文内容，限制在 5000 字符以内

工具能力 3

full-web-search 只读

执行综合搜索，返回搜索结果及每页的完整内容。

get-web-search-summaries 只读

轻量级搜索，仅返回结果摘要，不提取网页正文。

get-single-web-page-content 只读

提取指定 URL 的正文内容，去除导航和广告等非内容元素。

使用场景

为本地 LLM 提供实时网页搜索

获取搜索结果摘要或完整网页内容

从已知 URL 提取正文内容

支持客户端

LM Studio

LibreChat

依据项目文档列出，未经本站实测。

详细介绍

这是一个基于 TypeScript 的 MCP 服务器，为本地大语言模型提供无需 API 密钥的网页搜索功能。它通过多引擎（Bing、Brave、DuckDuckGo）搜索、完整网页内容提取、并发处理和浏览器自动化，为本地 LLM 提供实时网页信息检索能力。专为 LM Studio 和 LibreChat 等本地 LLM 客户端设计，支持通过环境变量灵活配置。