如果你关心搜索隐私,不希望你的每一次查询都被记录和分析,但又想让你的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 |
| 开源状态 | 公开状态 |
| Languages | TypeScript, 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的安装非常快捷,因为它可以通过npm或npx直接运行。
重要说明:该项目作者已宣布此仓库为“已弃用”,并推荐使用其继任者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参数)。
问题五:我可以指定搜索的物理位置(地区)吗?
解决方案:目前服务器没有暴露明确的region或location参数。不过,SearXNG实例本身的地理位置会影响其结果倾向(例如,美国托管的实例可能更偏向英文、美国结果)。连接到不同地区的实例可以达到类似地区切换的效果。未来继任项目可能会增加此参数。
七、总结
searxng-mcp是一个具有鲜明特色的MCP服务器。在几乎所有其他搜索MCP都在引导你使用商业API密钥时,它选择了一条不同的路:尊重隐私、零配置、无追踪。它通过SearXNG这个隐私友好的元搜索引擎,为AI助手提供了一个干净、自由的信息获取渠道。
这个项目最大的价值在于其理念和简便性。它证明了,联网搜索不一定以牺牲隐私为代价。它的零配置特性,让任何用户都能在几秒钟内为AI添加搜索能力,而不必经历注册开发者账号、申请API密钥的繁琐流程。
当然,项目也有一些局限性。使用公共实例时可能遭遇速率限制,且项目本身已标记为弃用,未来的维护和支持需要依赖社区或其继任者。但对于个人使用、隐私敏感或仅仅是想要快速体验AI联网搜索的用户来说,它依然是一个非常棒的选择。
如果你重视数字隐私,或者只是希望以最无痛的方式让你的AI获得搜索能力,searxng-mcp值得你立刻尝试。它让你看到,AI与隐私,可以共存。
我用它来辅助投资研究。搜索财经新闻时,不希望我的查询行为被追踪,这个工具满足了我的需求。
This project is a reminder that the open web is still alive. We don't have to route everything through megacorps.
同时配置了这个和另一个Google搜索MCP,根据场景切换。查隐私敏感情报时用这个,日常用那个。
The Docker deployment works fine. I run my own SearXNG and this MCP server as containers. Clean setup.
教程很诚实,直接说明了项目已弃用的状态,并给出了替代方案。这种透明度值得赞赏。