★ FEATURED ARTICLE 人工智能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 服务器无需任何 API Key即可让 LM Studio、LibreChat 等本地 LLM 客户端直接调用 Bing、Brave、DuckDuckGo 进行网络搜索并抓取完整网页内容。本文将带你从零完成安装、mcp.json 配置和 Docker 部署几分钟内让你的本地 AI 拥有联网搜索能力。 web-search-mcp 能做什么web-search-mcp 基于 TypeScript 和 MCPModel Context Protocol标准构建对外提供 3 个专用工具工具名用途适用场景full-web-search搜索并抓取结果页的完整正文内容深度调研、问答引用get-web-search-summaries只返回搜索摘要片段不跟进网页快速浏览、节省上下文get-single-web-page-content按 URL 提取单页正文去除导航、广告已知链接的正文提取它的几个亮点特性多引擎自动降级优先 Bing → Brave → DuckDuckGo任一引擎失败自动切换相关逻辑见 src/search-engine.ts⚡双通道内容提取先用 axios 快速请求失败达到阈值后自动切换 Playwright 浏览器并模拟人类行为实现于 src/enhanced-content-extractor.ts浏览器池隔离每个引擎使用独立浏览器实例自动清理防内存泄漏核心实现在 src/browser-pool.ts内置速率限制每分钟最多 10 次搜索、5 个并发提取见 src/rate-limiter.ts 模型兼容性提示官方测试中Qwen3、Gemma 3 表现最好较新的 Llama 3.1/3.2、DeepSeek R1 也可用较旧版本模型可能出现工具调用不稳定。✅ 安装前准备版本要求一键检查项目要求Node.js ≥ 18.0.0和npm ≥ 8.0.0先在终端确认版本node -v npm -v版本不满足时请先升级 Node.js这是后续所有步骤的基础。 最快安装步骤3 条命令完成构建方式一推荐从项目 Releases 页面下载最新 release 的 zip 包解压到固定位置例如~/mcp-servers/web-search-mcp/。方式二直接克隆源码构建git clone https://gitcode.com/gh_mirrors/we/web-search-mcp cd web-search-mcp接下来在项目根目录执行注意不要在dist/里执行npm install npx playwright install npm run build三条命令分别完成安装依赖 → 下载 Playwright 浏览器搜索必需→ 编译 TypeScript最终生成入口文件dist/index.js即后续 mcp.json 要指向的目标。 mcp.json 配置详解LM Studio 接入步骤web-search-mcp 以stdio 方式运行配置非常简洁。参考仓库自带的 mcp.json基本配置如下{ mcpServers: { web-search: { command: node, args: [/path/to/extracted/web-search-mcp/dist/index.js] } } }把/path/to/...替换为实际路径即可各平台示例macOS / Linux~/mcp-servers/web-search-mcp/dist/index.jsWindowsC:\\mcp-servers\\web-search-mcp\\dist\\index.jsLM Studio 接入流程打开 LM Studio进入Tools → MCP Servers不同版本入口可能略有差异选择编辑/添加 MCP 配置粘贴上面的 JSON 并保存启用web-search服务器确认状态显示为已连接在任意支持 MCP 的对话中提问例如搜索一下 TypeScript MCP server 是什么模型即可自动调用full-web-search进阶配置通过 env 微调行为遇到内容过长导致的异常行为、或想控制内存占用时加上env段{ mcpServers: { web-search: { command: node, args: [/path/to/web-search-mcp/dist/index.js], env: { MAX_CONTENT_LENGTH: 10000, BROWSER_HEADLESS: true, MAX_BROWSERS: 3, BROWSER_FALLBACK_THRESHOLD: 3 } } } } LibreChat Docker 部署技巧两步挂载配置如果你用 Docker 运行 LibreChatMCP 服务器运行在容器内必须先挂载本地目录再声明服务器分两步走第 1 步在docker-compose.override.yml中挂载目录到容器services: api: volumes: - type: bind source: /path/to/your/mcp/directory target: /app/mcp第 2 步在librechat.yaml中声明 MCP 服务器mcpServers: web-search: type: stdio command: node args: - /app/mcp/web-search-mcp/dist/index.js serverInstructions: true⚠️ 关键点容器内路径以/app/mcp开头对应上一步的target而不是宿主机的绝对路径。改完后重启 LibreChat 容器即可生效。⚙️ 常用环境变量速查表以下变量均可在 mcp.json 的env中设置来源README.md变量默认值作用MAX_CONTENT_LENGTH500000单页提取内容的最大字符数DEFAULT_TIMEOUT6000单次请求超时毫秒MAX_BROWSERS3浏览器池最大实例数BROWSER_TYPESchromium,firefox可用浏览器类型可加 webkitBROWSER_HEADLESStrue无头模式服务器环境建议保持开启BROWSER_FALLBACK_THRESHOLD3axios 失败几次后切换浏览器兜底ENABLE_RELEVANCE_CHECKINGtrue是否校验搜索结果相关性RELEVANCE_THRESHOLD0.3相关性最低得分0.0-1.0FORCE_MULTI_ENGINE_SEARCHfalse强制多引擎搜索并返回最优结果DEBUG_BROWSER_LIFECYCLEfalse输出浏览器生命周期调试日志 常见问题排查清单问题解决办法npm install失败升级 Node.js 至 18、npm 至 8搜索无结果重新执行npx playwright install确认BROWSER_HEADLESStrue响应太慢设置DEFAULT_TIMEOUT4000或MAX_BROWSERS1降低资源消耗内容过长导致异常在env中设置MAX_CONTENT_LENGTH10000部分结果被屏蔽某些网络会拦截浏览器自动化尝试更换网络环境 部署后如何验证单独运行在根目录执行npm start看到 Web Search MCP Server started 即启动成功入口逻辑见 src/index.ts测试脚本仓库提供了引擎测试脚本如 tests/test-all-engines.js、tests/test-brave.js可单独验证各搜索引擎连通性在客户端提问向 LM Studio / LibreChat 提一个需要联网的问题观察是否触发full-web-search工具调用 总结安装npm installnpx playwright installnpm run build产出dist/index.jsLM Studio在 MCP 配置中写入command: node加args指向入口文件LibreChatDocker先挂载目录到/app/mcp再在librechat.yaml声明mcpServers调优按需调整MAX_CONTENT_LENGTH、MAX_BROWSERS等环境变量完整技术细节可参阅 docs/API.md许可证为 MIT见 LICENSE。现在你的本地大模型已经可以上网了 赞分享人工智能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点击查看免费下载相关推荐如何把 GitHub Copilot 接入外部 PostgreSQL配置 .mcp.json 与 /mcp 安装流程如何把 GitHub Copilot 接入外部 PostgreSQL配置 .mcp.json 与 /mcp 安装流程 如果你的目标是让 GitHub Copi文档知识库AI 技能/插件AtomCode MCP 服务器接入实战指南从 .mcp.json 配置到精选服务清单AtomCode MCP 服务器接入实战指南从 .mcp.json 配置到精选服务清单 MCPModel Context Protocol模型上下文协议人工智能AI Agent代码智能体自主智能体MCP ClientsCLIWarp MCP 服务器配置指南通过 .mcp.json 原生配置文件接入 MCP ServerWarp MCP 服务器配置指南通过 .mcp.json 原生配置文件接入 MCP Server 导读 Warp 作为诞生于终端、面向 Agent 的开发环境桌面应用开发者工具人工智能AI 应用AI Agent代码智能体创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
