如果你关心搜索隐私,不希望你的每一次查询都被记录和分析,但又想让你的AI助手能够实时联网获取信息,那么如何在隐私和便利之间取得平衡?SearXNG给出了答案。searxng-mcp则是一个巧妙的桥梁,它将SearXNG这个尊重隐私的元搜索引擎的能力,通过模型上下文协议赋予了你的AI助手。

searxng-mcp是一个模型上下文协议服务器,它让你的AI能够通过SearXNG执行网络搜索。SearXNG本身是一个元搜索引擎,它聚合了来自Google、Bing、DuckDuckGo等多个搜索引擎的结果,同时不会追踪你,不会记录你的IP地址,也不会建立你的个人画像。通过这个服务器,你的AI可以在不牺牲隐私的前提下,获得实时、多元化的搜索结果。

项目基本信息

信息项详情
项目名称searxng-mcp
GitHub地址https://github.com/tisDDM/searxng-mcp
项目描述A Model Context Protocol (MCP) server that enables AI assistants to perform web searches using SearXNG, a privacy-respecting metasearch engine.
作者tisDDM
开源协议MIT License
开源状态公开状态
LanguagesTypeScript, JavaScript
支持平台Windows / macOS / Linux
最后更新2026-04-20

一、项目介绍

searxng-mcp的核心是一个名为searxngsearch的工具。通过这个工具,你的AI可以执行高度可控的网络搜索,并获得格式化后的结果。

这个服务器最吸引人的特点是其零配置开箱即用的设计。它默认会从SearX.space这个公共实例列表中,随机选择一个可用的SearXNG实例。这意味着你不需要注册、不需要API密钥、甚至不需要自己搭建任何服务,就能立刻让AI拥有隐私保护的搜索能力。

当然,如果你有自己的SearXNG私有实例,或者希望连接到一个特定的公开实例,也可以轻松配置。它还支持基本认证,适用于需要登录的私有实例。

搜索工具本身提供了丰富的参数。你可以指定搜索语言、时间范围(一天到一年)、搜索类别(通用、图片、新闻等)、甚至指定特定的搜索引擎(如只从Google和维基百科搜索)。你还可以设置安全搜索级别和分页,并控制返回结果的最大数量(最多50条)。

二、核心优势

隐私优先,不妥协:这是该项目最核心的价值。所有的搜索请求都通过SearXNG发出,你的查询词、IP地址等隐私信息不会被任何单一的搜索引擎(如Google)直接收集。SearXNG本身的设计就是不追踪、不记录。这让你的AI助手在获取实时信息的同时,也能尊重你的数据隐私。

零配置,立即使用:你不需要申请API密钥,不需要绑定信用卡,甚至不需要了解SearXNG是什么。只需要像配置其他MCP服务器一样,在客户端中添加几行配置,你的AI就能立刻进行联网搜索。这种“傻瓜式”的上手体验,大大降低了使用门槛。

多搜索引擎聚合:SearXNG是一个元搜索引擎,它同时查询多个后端搜索引擎,然后将结果合并去重后返回。这意味着你的AI获得的结果是多元化的,不局限于某一家的搜索索引,有助于打破“信息茧房”。如果你的配置中指定了多个引擎,还能看到不同来源对同一查询的不同结果。

灵活的搜索参数:服务器暴露了SearXNG大部分核心搜索参数。你可以让AI只搜索过去一周的新闻,或者只从“学术”类别中查找结果,或者指定使用维基百科作为唯一搜索源。这种粒度的控制力,让AI能够进行非常精准的信息挖掘。

三、适用场景

场景一:注重隐私的个人助手。如果你是隐私倡导者,不信任商业搜索引擎的数据收集行为,但又希望你的AI有联网能力。这个服务器是绝佳选择。你可以开箱即用,或者连接到自己托管的私有SearXNG实例,实现完全的隐私控制。

场景二:快速信息查证。在对话中,你可以随时让AI:“用SearXNG搜索一下‘2026年欧洲杯赛程’,只返回来自新闻类别的结果。” AI会进行隐私搜索,并给出赛程信息。

场景三:跨搜索引擎结果对比。你可以让AI对比不同搜索引擎的结果。“请分别通过Google和Bing的后台,搜索‘大语言模型’这个关键词,然后告诉我结果首页的前三条有什么不同。” 这需要SearXNG配置了这两个引擎。

场景四:时效性信息检索。你可以利用time_range参数。“搜索过去一周内关于‘特斯拉新款电动车’的新闻。” AI能返回最近7天的相关报道,避免被旧信息干扰。

场景五:开发隐私保护的AI应用。如果你正在开发一个AI应用,不希望因为集成了搜索API而引入隐私合规风险。可以以searxng-mcp为基础,构建你的搜索模块。它既有完整的功能,又天然具备隐私友好特性。

四、安装教程

searxng-mcp的安装非常快捷,因为它可以通过npmnpx直接运行。

重要说明:该项目作者已宣布此仓库为“已弃用”,并推荐使用其继任者searxNcrawl。不过,当前的版本对于日常搜索功能仍然是完整可用的。如果你追求最新的功能和维护,可以考虑使用继任项目;如果想快速开始一个简单、隐私的搜索MCP,当前版本依然是一个稳定的选择。

第一步:确保Node.js环境

请确认你的系统已安装Node.js 16或更高版本。你可以在终端输入node --version来检查。如果未安装,请前往Node.js官网下载。

第二步:配置你的MCP客户端

配置文件示例以Claude Desktop为例。找到其配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

使用文本编辑器打开该文件,添加以下配置:

{
  "mcpServers": {
    "searxngmcp": {
      "command": "npx",
      "args": ["-y", "searxng-mcp"]
    }
  }
}

这个配置利用了默认行为:服务器会随机选择一个公共SearXNG实例。你不需要设置任何环境变量

如果你希望连接到自己托管的私有实例,可以这样配置:

{
  "mcpServers": {
    "searxngmcp": {
      "command": "npx",
      "args": ["-y", "searxng-mcp"],
      "env": {
        "SEARXNG_URL": "https://你的searxng实例地址",
        "SEARXNG_USERNAME": "你的用户名",
        "SEARXNG_PASSWORD": "你的密码"
      }
    }
  }
}

对于Windows用户,如果npx无法直接运行,可以用cmd包装:

{
  "mcpServers": {
    "searxngmcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "searxng-mcp"]
    }
  }
}

第三步:重启并验证

保存配置文件,完全退出Claude Desktop并重新启动。在新的对话中,尝试提问:“请用SearXNG搜索一下‘隐私保护’这个关键词,返回5个结果。”

如果配置成功,AI会调用searxngsearch工具,并返回一个包含标题、链接和摘要的搜索结果列表。

五、使用示例

配置完成后,你就可以用自然语言让AI执行隐私保护的搜索了。

示例一:基础搜索

你问:“帮我搜索一下‘SearXNG是什么’。”

AI会调用工具,使用默认参数进行搜索,然后返回结果列表。

示例二:带时间范围的新闻搜索

你问:“搜索过去一个月内,关于‘气候变化’的新闻,只从新闻类别中找。”

AI会设置categories: ["news"]time_range: "month"

示例三:限制结果数量和来源

你问:“只从维基百科搜索‘量子计算’,给我返回3个结果。”

AI会设置engines: ["wikipedia"]max_results: 3

示例四:调整安全搜索级别

你问:“搜索‘苹果公司’,使用严格的安全搜索模式。”

AI会设置safesearch: 2(严格模式)。

示例五:多页搜索

你问:“搜索‘Python教程’,我要看第二页的结果。”

AI会设置pageno: 2

六、常见问题

问题一:搜索时返回“429 Too Many Requests”错误。

解决方案:这是使用公共SearXNG实例时最常见的问题。429错误意味着你使用的公共实例认为来自该IP的请求过于频繁,进行了速率限制。你可以尝试:稍后再试;等待几分钟让限制重置;或者自己搭建一个私有SearXNG实例(这是最可靠的解决方案),然后在配置中指定SEARXNG_URL

问题二:服务器提示“已弃用(deprecated)”,我还能用吗?

解决方案:是的,你仍然可以使用。作者标记为“已弃用”意味着未来将不再积极维护和更新,但当前的版本(v0.2.0)功能是完整的,可以正常工作。对于希望获得长期支持和最新特性的用户,建议迁移到继任项目searxNcrawl

问题三:如何确认当前使用的是哪个SearXNG实例?

解决方案:默认情况下,服务器会从SearX.space列表中随机选择一个。如果你想固定使用某个特定的可靠公共实例,可以在环境变量SEARXNG_URL中指定其地址。一些已知稳定的公共列表可以在SearXNG官方文档或社区中找到。

问题四:max_results参数最大真的只能到50吗?

解决方案:是的,这是目前服务器的限制。SearXNG API本身可以返回更多,但50条对于大多数AI使用场景已经足够。如果你需要更多结果,可以调整搜索关键词使其更精准,或者进行多次分页查询(使用pageno参数)。

问题五:我可以指定搜索的物理位置(地区)吗?

解决方案:目前服务器没有暴露明确的regionlocation参数。不过,SearXNG实例本身的地理位置会影响其结果倾向(例如,美国托管的实例可能更偏向英文、美国结果)。连接到不同地区的实例可以达到类似地区切换的效果。未来继任项目可能会增加此参数。

七、总结

searxng-mcp是一个具有鲜明特色的MCP服务器。在几乎所有其他搜索MCP都在引导你使用商业API密钥时,它选择了一条不同的路:尊重隐私、零配置、无追踪。它通过SearXNG这个隐私友好的元搜索引擎,为AI助手提供了一个干净、自由的信息获取渠道。

这个项目最大的价值在于其理念简便性。它证明了,联网搜索不一定以牺牲隐私为代价。它的零配置特性,让任何用户都能在几秒钟内为AI添加搜索能力,而不必经历注册开发者账号、申请API密钥的繁琐流程。

当然,项目也有一些局限性。使用公共实例时可能遭遇速率限制,且项目本身已标记为弃用,未来的维护和支持需要依赖社区或其继任者。但对于个人使用、隐私敏感或仅仅是想要快速体验AI联网搜索的用户来说,它依然是一个非常棒的选择。

如果你重视数字隐私,或者只是希望以最无痛的方式让你的AI获得搜索能力,searxng-mcp值得你立刻尝试。它让你看到,AI与隐私,可以共存。

标签: 搜索与检索

已有 32 条评论

    1. DavidKim DavidKim

      作为一个开发者,我欣赏它的简洁。代码量不大,但核心功能完整,很容易理解其工作原理。

    2. LucasBrown LucasBrown

      Great tutorial! The explanation of the 429 error and how to mitigate it is very practical.

    3. MiaWilson MiaWilson

      我把它和Home Assistant集成,作为家庭助理的搜索后端。现在问家里机器人问题,也能保护隐私了。

    4. EthanJones EthanJones

      参数`engines`是个隐藏宝藏。我指定只搜`arxiv`和`wikipedia`,用来做学术和百科查询,非常高效。

    5. AmeliaTaylor AmeliaTaylor

      希望继任项目能增加对搜索结果去重的控制。有时候不同引擎会返回相同链接。