人工智能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点击查看免费下载web-search-mcp是一个本地托管的 Web 搜索 MCP Server通过 Playwright 管理多个无头浏览器实例来为 Local LLM 提供搜索与网页正文提取能力。它的核心组件BrowserPoolbrowser-pool.ts用一个 Map 按浏览器类型缓存实例并内置了类型轮换、健康检查、自动清理三大机制让多实例长期运行不泄漏、不掉线。BrowserPool 是什么解决什么问题每次用 Playwright 都launch一个新浏览器代价很高冷启动慢、内存占用大但一直复用同一个实例又可能遇到进程假死、会话断开等问题。BrowserPool的设计就是在这两者之间取平衡按类型缓存内部用Mapstring, Browser存放实例每个浏览器类型chromium / firefox / webkit最多保留一个按需复用再次需要同类型浏览器时先体检健康则直接复用有损自愈实例不健康就关闭并重新拉起业务层无感知项目中有两处独立的池实例在使用它搜索引擎search-engine.ts和内容提取器enhanced-content-extractor.ts两者各自管理自己的浏览器生命周期。一行配置通过环境变量调节池子大小BrowserPool构造函数完全由环境变量驱动browser-pool.ts在mcp.json的env中即可调整环境变量默认值作用MAX_BROWSERS3池内最多保留的浏览器实例数超出后自动淘汰最旧实例BROWSER_TYPESchromium,firefox逗号分隔的轮换列表可加webkitBROWSER_HEADLESStrue设为false才显示浏览器窗口例如内存紧张时可设置MAX_BROWSERS1想只用 Chromium 则设BROWSER_TYPESchromium。机制一浏览器类型轮换Round-Robin每次调用getBrowser()时池子会按顺序在BROWSER_TYPES列表中取下一个类型chromium → firefox → chromium → firefox → ...实现非常轻量一个递增计数器对类型列表长度取模browser-pool.ts并通过getLastUsedBrowserType()告诉调用方本次实际拿到了哪种浏览器。为什么要轮换规避针对性反爬不同网站的 bot 检测策略不同交替使用 Chromium 与 Firefox 能降低被单一指纹识别的概率分散负载避免所有自动化流量都带着同一浏览器内核特征容错某种类型在本机环境有兼容问题时如某些服务器上 Firefox 的 isMobile 限制轮换机制会自动绕过去调用方拿到lastUsedBrowserType后还能做差异化处理——比如内容提取器会据此判断是否为 Firefox跳过它不支持的isMobile上下文选项enhanced-content-extractor.ts。机制二健康检查拒绝“僵尸浏览器”复用前必须确认实例还活着。getBrowser()的体检分两步连接检查browser.isConnected()判断进程通道是否还在响应性检查尝试创建并立即关闭一个测试 context——这是真实操作能发现连接显示正常但实际无响应的僵尸状态browser-pool.ts体检失败时池子会把该类型从 Map 中移除 → 尝试close()回收进程关闭失败也只记日志、不阻塞→ 走全新launch流程拉起替代实例。整个自愈过程对上层是透明的业务代码永远只需要await pool.getBrowser()一行。 类似的体检逻辑在搜索引擎侧也有独立实现validateBrowserHealthsearch-engine.ts配合DEBUG_BROWSER_LIFECYCLEtrue环境变量可输出详细的浏览器生命周期日志便于排障。机制三自动清理防止内存泄漏浏览器实例是内存大户BrowserPool在两个层面控制规模1. 容量淘汰LRU 风格每次新实例入池后如果browsers.size超过MAX_BROWSERS就会取 Map 中最先进入的条目关闭并从池中删除browser-pool.ts。Map 的插入顺序天然充当了最旧优先淘汰的队列。2. 会话级与进程级清理搜索完成后MCP Server 会调用searchEngine.closeAll()清空池子防止 EventEmitter 监听器随浏览器累积造成内存泄漏index.ts收到SIGINT/SIGTERM信号时优雅关闭流程会并发调用内容提取器与搜索引擎两个池的closeAll()确保进程退出前所有浏览器都被回收index.ts检测到浏览器已关闭类错误如Browser has been closed时handleBrowserError会主动closeAll()刷新整个池让下一次尝试拿到全新实例search-engine.tscloseAll()本身也是容错的对所有实例并发close()单个失败不影响其他实例最后清空 Mapbrowser-pool.ts。拉新实例时的隐身启动参数池子新建浏览器时并非裸启动而是一组反自动化检测参数browser-pool.ts常见的几个--disable-blink-featuresAutomationControlled关闭 Blink 自动化特征--no-sandbox、--disable-dev-shm-usage适配容器/低共享内存环境--disable-gpu无头服务器上禁用 GPU 渲染--disable-extensions禁止扩展干扰再加上调用方创建 context 时注入的随机 User-Agent、视口、时区以及移除navigator.webdriver的 stealth 脚本enhanced-content-extractor.ts整体大幅降低了被目标站点识别为自动化的概率。常见问题排查速查症状建议操作内存占用持续增长调小MAX_BROWSERS确认搜索工具执行完触发了closeAll浏览器启动失败执行npx playwright install确认内核已安装检查BROWSER_TYPES拼写需要调试浏览器生命周期设置DEBUG_BROWSER_LIFECYCLEtrue观察控制台日志某些网站抓取被拦截利用类型轮换交替内核确认BROWSER_HEADLESStrue未被意外覆盖相关文件一览池核心实现browser-pool.ts —— 轮换、体检、淘汰、closeAll全在此文件搜索侧消费者search-engine.ts —— 浏览器错误处理与池刷新提取侧消费者enhanced-content-extractor.ts —— 浏览器兜底提取入口服务装配与优雅退出index.ts配置说明与环境变量README.md、docs/API.md小结BrowserPool用一个不到 130 行的类把多浏览器实例怎么管这个问题拆解成了三个可独立理解的机制按类型轮换分散风险、用真实操作做健康检查拒绝僵尸实例、按容量加生命周期钩子双保险自动清理。对新手而言这套模式——缓存 体检 容量淘汰——也是管理任何昂贵共享资源数据库连接、HTTP Agent、GPU 上下文时的通用参考模板。赞分享人工智能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点击查看免费下载相关推荐终极MCP服务器健康检查自动化mcp-use监控集成完整指南终极MCP服务器健康检查自动化mcp use监控集成完整指南 MCP服务器健康检查是保障服务稳定运行的关键环节而mcp use提供了一套完整的监控集成方案后端MCP 服务MCP ClientsAI Agent人工智能容器健康检查终极指南如何实时监控与自动修复container30容器状态容器健康检查终极指南如何实时监控与自动修复container30容器状态 container30是一款专为Apple silicon优化的轻量级Linux容器CLI虚拟化容器运行时云原生鸣潮 ok-ww 完整指南后台自动战斗、刷声骸与一键日常鸣潮 ok ww 完整指南后台自动战斗、刷声骸与一键日常 ok ww 是一款面向《鸣潮》PC 端的免费开源自动化工具。它基于图像识别通过模拟鼠标键盘操作完成GUI 自动化计算机视觉RPA人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/14 20:27:33 · 阅读 1.2k 如何管理多浏览器实例不翻车？web-search-mcp 的 BrowserPool 轮换、健康检查与自动清理完整指南
人工智能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点击查看免费下载web-search-mcp是一个本地托管的 Web 搜索 MCP Server通过 Playwright 管理多个无头浏览器实例来为 Local LLM 提供搜索与网页正文提取能力。它的核心组件BrowserPoolbrowser-pool.ts用一个 Map 按浏览器类型缓存实例并内置了类型轮换、健康检查、自动清理三大机制让多实例长期运行不泄漏、不掉线。BrowserPool 是什么解决什么问题每次用 Playwright 都launch一个新浏览器代价很高冷启动慢、内存占用大但一直复用同一个实例又可能遇到进程假死、会话断开等问题。BrowserPool的设计就是在这两者之间取平衡按类型缓存内部用Mapstring, Browser存放实例每个浏览器类型chromium / firefox / webkit最多保留一个按需复用再次需要同类型浏览器时先体检健康则直接复用有损自愈实例不健康就关闭并重新拉起业务层无感知项目中有两处独立的池实例在使用它搜索引擎search-engine.ts和内容提取器enhanced-content-extractor.ts两者各自管理自己的浏览器生命周期。一行配置通过环境变量调节池子大小BrowserPool构造函数完全由环境变量驱动browser-pool.ts在mcp.json的env中即可调整环境变量默认值作用MAX_BROWSERS3池内最多保留的浏览器实例数超出后自动淘汰最旧实例BROWSER_TYPESchromium,firefox逗号分隔的轮换列表可加webkitBROWSER_HEADLESStrue设为false才显示浏览器窗口例如内存紧张时可设置MAX_BROWSERS1想只用 Chromium 则设BROWSER_TYPESchromium。机制一浏览器类型轮换Round-Robin每次调用getBrowser()时池子会按顺序在BROWSER_TYPES列表中取下一个类型chromium → firefox → chromium → firefox → ...实现非常轻量一个递增计数器对类型列表长度取模browser-pool.ts并通过getLastUsedBrowserType()告诉调用方本次实际拿到了哪种浏览器。为什么要轮换规避针对性反爬不同网站的 bot 检测策略不同交替使用 Chromium 与 Firefox 能降低被单一指纹识别的概率分散负载避免所有自动化流量都带着同一浏览器内核特征容错某种类型在本机环境有兼容问题时如某些服务器上 Firefox 的 isMobile 限制轮换机制会自动绕过去调用方拿到lastUsedBrowserType后还能做差异化处理——比如内容提取器会据此判断是否为 Firefox跳过它不支持的isMobile上下文选项enhanced-content-extractor.ts。机制二健康检查拒绝“僵尸浏览器”复用前必须确认实例还活着。getBrowser()的体检分两步连接检查browser.isConnected()判断进程通道是否还在响应性检查尝试创建并立即关闭一个测试 context——这是真实操作能发现连接显示正常但实际无响应的僵尸状态browser-pool.ts体检失败时池子会把该类型从 Map 中移除 → 尝试close()回收进程关闭失败也只记日志、不阻塞→ 走全新launch流程拉起替代实例。整个自愈过程对上层是透明的业务代码永远只需要await pool.getBrowser()一行。 类似的体检逻辑在搜索引擎侧也有独立实现validateBrowserHealthsearch-engine.ts配合DEBUG_BROWSER_LIFECYCLEtrue环境变量可输出详细的浏览器生命周期日志便于排障。机制三自动清理防止内存泄漏浏览器实例是内存大户BrowserPool在两个层面控制规模1. 容量淘汰LRU 风格每次新实例入池后如果browsers.size超过MAX_BROWSERS就会取 Map 中最先进入的条目关闭并从池中删除browser-pool.ts。Map 的插入顺序天然充当了最旧优先淘汰的队列。2. 会话级与进程级清理搜索完成后MCP Server 会调用searchEngine.closeAll()清空池子防止 EventEmitter 监听器随浏览器累积造成内存泄漏index.ts收到SIGINT/SIGTERM信号时优雅关闭流程会并发调用内容提取器与搜索引擎两个池的closeAll()确保进程退出前所有浏览器都被回收index.ts检测到浏览器已关闭类错误如Browser has been closed时handleBrowserError会主动closeAll()刷新整个池让下一次尝试拿到全新实例search-engine.tscloseAll()本身也是容错的对所有实例并发close()单个失败不影响其他实例最后清空 Mapbrowser-pool.ts。拉新实例时的隐身启动参数池子新建浏览器时并非裸启动而是一组反自动化检测参数browser-pool.ts常见的几个--disable-blink-featuresAutomationControlled关闭 Blink 自动化特征--no-sandbox、--disable-dev-shm-usage适配容器/低共享内存环境--disable-gpu无头服务器上禁用 GPU 渲染--disable-extensions禁止扩展干扰再加上调用方创建 context 时注入的随机 User-Agent、视口、时区以及移除navigator.webdriver的 stealth 脚本enhanced-content-extractor.ts整体大幅降低了被目标站点识别为自动化的概率。常见问题排查速查症状建议操作内存占用持续增长调小MAX_BROWSERS确认搜索工具执行完触发了closeAll浏览器启动失败执行npx playwright install确认内核已安装检查BROWSER_TYPES拼写需要调试浏览器生命周期设置DEBUG_BROWSER_LIFECYCLEtrue观察控制台日志某些网站抓取被拦截利用类型轮换交替内核确认BROWSER_HEADLESStrue未被意外覆盖相关文件一览池核心实现browser-pool.ts —— 轮换、体检、淘汰、closeAll全在此文件搜索侧消费者search-engine.ts —— 浏览器错误处理与池刷新提取侧消费者enhanced-content-extractor.ts —— 浏览器兜底提取入口服务装配与优雅退出index.ts配置说明与环境变量README.md、docs/API.md小结BrowserPool用一个不到 130 行的类把多浏览器实例怎么管这个问题拆解成了三个可独立理解的机制按类型轮换分散风险、用真实操作做健康检查拒绝僵尸实例、按容量加生命周期钩子双保险自动清理。对新手而言这套模式——缓存 体检 容量淘汰——也是管理任何昂贵共享资源数据库连接、HTTP Agent、GPU 上下文时的通用参考模板。赞分享人工智能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点击查看免费下载相关推荐终极MCP服务器健康检查自动化mcp-use监控集成完整指南终极MCP服务器健康检查自动化mcp use监控集成完整指南 MCP服务器健康检查是保障服务稳定运行的关键环节而mcp use提供了一套完整的监控集成方案后端MCP 服务MCP ClientsAI Agent人工智能容器健康检查终极指南如何实时监控与自动修复container30容器状态容器健康检查终极指南如何实时监控与自动修复container30容器状态 container30是一款专为Apple silicon优化的轻量级Linux容器CLI虚拟化容器运行时云原生鸣潮 ok-ww 完整指南后台自动战斗、刷声骸与一键日常鸣潮 ok ww 完整指南后台自动战斗、刷声骸与一键日常 ok ww 是一款面向《鸣潮》PC 端的免费开源自动化工具。它基于图像识别通过模拟鼠标键盘操作完成GUI 自动化计算机视觉RPA人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考