首页
/
行业洞察
/
正文
INDUSTRY INSIGHT · 深度
5分钟快速上手 web-search-mcp:从零搭建本地 MCP 网页搜索服务器的完整教程
📅 2026/10/13 22:26:46
✍️ 爱科研究院
👁 阅读 3,247
人工智能MCP 服务【免费下载链接】web-search-mcpA simple, locally hosted Web Search MCP server for use with Local LLMs项目地址https://gitcode.com/gh_mirrors/we/web-search-mcp点击查看免费下载想给你的本地大模型Local LLM加上真实联网搜索能力吗web-search-mcp 是一个用 TypeScript 编写的本地网页搜索 MCP 服务器无需任何 API Key通过直连 Bing、Brave、DuckDuckGo 三大搜索引擎实现网页搜索还能自动抓取并提取结果页面的完整正文。本教程带你从零搭建5分钟即可让 LM Studio、LibreChat 等客户端的 AI 助手拥有搜索 阅读网页的双重能力。为什么选择 web-search-mcp 本地搜索方案很多 MCP 搜索工具依赖付费 API而 web-search-mcp 走的是直连搜索引擎路线对新手非常友好特性说明 免 API Key直接连接 Bing Brave DuckDuckGo按可靠性自动降级切换 完整正文提取不只返回摘要还会跟进链接抓取整页内容️ 3 个专用工具面向不同搜索场景按需调用⚡ 智能请求策略先用轻量 axios 请求失败自动切换 Playwright 浏览器模拟真人访问 并发处理同时提取多个页面内容带超时保护速度快搜索引擎与浏览器实例的实现核心在 src/search-engine.ts它按 BingChromium→ BraveFirefox→ DuckDuckGoHTTP的顺序逐级降级保证尽量返回结果。准备工作环境要求清单开始之前请确认你的电脑满足以下要求package.json 中的硬性要求✅ Node.js18.0.0或更高版本✅ npm8.0.0或更高版本检查版本只需两条命令node -v npm -v 如果版本不满足升级到最新版 Node.js 即可这是后续npm run build编译成功的前提。安装步骤4 条命令完成部署第 1 步获取项目源码git clone https://gitcode.com/gh_mirrors/we/web-search-mcp cd web-search-mcp第 2 步安装依赖 浏览器 构建在解压或克隆的根目录依次执行npm install npx playwright install npm run build这三条命令分别完成npm install—— 安装所有依赖axios、playwright、zod 等生成node_modulesnpx playwright install—— 下载 Playwright 所需的 Chromium / Firefox 浏览器内核npm run build—— 将 TypeScript 编译为 JavaScript产出最终的dist/index.js第 3 步验证构建成功构建完成后根目录会生成dist/文件夹里面的dist/index.js就是你稍后要配置给 MCP 客户端的入口文件。⚠️ 注意npm install必须在解压后的根目录执行而不是dist/目录里。客户端配置让 AI 助手接入网页搜索服务器构建完成后只需把 MCP 客户端的mcpServers指向dist/index.js。仓库自带的 mcp.json 就是最小配置模板。通用配置LM Studio 等标准 MCP 客户端{ mcpServers: { web-search: { command: node, args: [/path/to/web-search-mcp/dist/index.js] } } }其中路径按系统替换macOS / Linux~/mcp-servers/web-search-mcp/dist/index.jsWindowsC:\mcp-servers\web-search-mcp\dist\index.jsLibreChat 用户可以在librechat.yaml中配置mcpServers: web-search: type: stdio command: node args: - /path/to/web-search-mcp/dist/index.js serverInstructions: true如果使用 Docker 运行 LibreChat记得先在docker-compose.override.yml中把本地 mcp 目录挂载进去详见 README.md 的 Docker 部分。三大核心工具给 AI 下达搜索指令配置完成后AI 会自动获得 3 个工具注册代码位于 src/index.ts。完整参数说明可查阅官方文档 docs/API.md。1️⃣ full-web-search —— 主力深度搜索最全面的工具搜索网页后跟进每个结果链接抓取完整正文返回适合深度调研。常用参数query必填、limit1-10默认 5、includeContent默认 true、maxContentLength单条内容最大字符数一般不用手动设置。2️⃣ get-web-search-summaries —— 轻量快速搜索执行同样的多引擎搜索但只返回结果摘要不跟进链接抓全文。速度快、效率高适合快速了解一个话题。3️⃣ get-single-web-page-content —— 单页内容提取直接传入一个 URL提取该页面的主体内容自动过滤导航栏、广告等噪音元素。适合我知道具体网址只要正文的场景。 选择口诀要全文用 ①要快用 ②有网址用 ③。常用环境变量按需微调性能在mcp.json的env字段中即可配置常用项如下变量作用默认值MAX_CONTENT_LENGTH单条内容最大字符数500000DEFAULT_TIMEOUT请求超时毫秒6000MAX_BROWSERS最大浏览器实例数3BROWSER_HEADLESS是否无头模式trueFORCE_MULTI_ENGINE_SEARCH强制尝试全部引擎取最优结果falseRELEVANCE_THRESHOLD结果质量阈值0.0-1.00.3示例配置降低内容长度 限制浏览器数量{ mcpServers: { web-search: { command: node, args: [/path/to/web-search-mcp/dist/index.js], env: { MAX_CONTENT_LENGTH: 10000, MAX_BROWSERS: 1 } } } }常见问题排查清单问题解决方案npm install失败升级 Node.js 到 18、npm 到 8npm run build报错确保安装最新版 Node.js搜索无结果执行npx playwright install确认浏览器已安装响应太慢设置DEFAULT_TIMEOUT4000或MAX_BROWSERS1内容被截断/行为异常设置MAX_CONTENT_LENGTH10000模型调用工具不稳定优先选用 Qwen3、Gemma 3 等新模型旧版 Llama/Deepseek 可能出错模型兼容性提示项目推荐搭配支持工具调用tool use的较新模型目前Qwen3和Gemma 3表现最好。小结到这里你的本地 MCP 网页搜索服务器就搭建完成了 回顾一下 5 分钟流程git clone获取源码npm installnpx playwright installnpm run build在客户端mcp.json中指向dist/index.js用三大工具full-web-search/get-web-search-summaries/get-single-web-page-content开始搜索全程无需注册任何 API数据请求全部走本地隐私可控。现在就可以对你的 AI 助手说搜索一下 TypeScript MCP 服务器把前 3 篇文章的完整内容读给我看看它的表现吧赞分享人工智能MCP 服务【免费下载链接】web-search-mcpA simple, locally hosted Web Search MCP server for use with Local LLMs项目地址https://gitcode.com/gh_mirrors/we/web-search-mcp点击查看免费下载相关推荐快速上手Firecrawl MCP5分钟搭建智能网页抓取服务器快速上手Firecrawl MCP5分钟搭建智能网页抓取服务器 Firecrawl MCP Server 是一个基于 Model Context ProtocMCP 服务网页爬虫AI 应用读懂 web-search-mcp 源码架构TypeScript MCP SDK 构建本地网页搜索服务器的开发指南读懂 web search mcp 源码架构TypeScript MCP SDK 构建本地网页搜索服务器的开发指南 web search mcp 是一个运人工智能MCP 服务5分钟快速搭建Sonic搜索服务器从零开始的完整指南5分钟快速搭建Sonic搜索服务器从零开始的完整指南 Sonic是一个快速、轻量级且无模式的搜索后端引擎是Elasticsearch的轻量级替代方案。这款高搜索引擎后端全文检索创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📌 标签:
工业官网
设计趋势
AI 建站
SEO
获取完整报告 →
RELATED ARTICLES
推荐阅读
2026/10/13 22:26:46
AI编程工具实战:选型、提示词与工作流嵌入,告别低效代码
2026/10/13 22:26:46
AI编程工具实战:从任务拆解到代码审查的完整工作流方法论
2026/10/13 22:26:46
游戏引擎基础系统解析:内存管理设计与生命周期实践
2026/10/13 23:31:56
Windows加载器探针LdrSetDllManifestProber:进程内DLL加载监视实战
2026/10/13 23:31:56
零基础学AI编程:从产品开发到变现的实操指南
2026/10/13 23:31:56
几百篇文献怎么读得完?科迅捷AI的文献综述功能了解一下
2026/10/13 23:31:56
技术面试速通指南:从技能矩阵到高并发项目复盘
2026/10/13 23:31:56
Python新手入门第一天:环境搭建、核心概念与避坑指南
2026/10/13 23:26:55
西电数据库真题:SQL能力探针与索引事务实战指南
2026/10/13 0:00:40
物联网系统集成避坑指南:从选型到验收的关键要点
2026/10/13 0:00:40
ESP32舵机控制全攻略:从PWM原理到高级玩法与常见故障排查
2026/10/13 0:00:40
CAN总线原理与STM32实战:抗干扰、仲裁、错误处理全解析
2026/10/13 12:25:09
流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南
2026/10/13 18:15:04
影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别
2026/10/13 8:14:22
影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容
2026/10/12 19:53:23
我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频
2026/10/11 21:41:11
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证
2026/10/11 23:43:10
2026 大模型集体涨价:用 Python 做企业 Token 成本测算与选型避坑(附配置)