
通过SearXNG为AI助手提供私密网页搜索——支持Claude、光标及任何MCP客户端
概览
一台集成 SearXNG API 的 MCP 服务器,赋予 AI 助手网页搜索功能。 添加到你的MCP客户端配置中(例如claude_desktop_config.json): 将YOUR_SEARXNG_INSTANCE_URL替换为您的SearXNG实例的URL(例如[[T0])。您也可以提供可互换的副本,作为分号分隔的列表,例如https://one.example.com;https://two.example.com. - : 通用查询、新闻、文章,带分页。- : 配置多个可互换的 SearXNG 副本SEARXNG_URL;搜索默认故障切换,并可选择并行展开。- : 选择格式化文本或带有 response_format 的原始 SearXNG 形状 JSON。- : 文本结果在结果列表前显示 SearXNG 的答案、更正、建议和信息框。- : 通过 SearXNG 的 /autocompleter 端点进行查询自动补全。- : 检查已配置的类别、引擎、默认设置、位置和插件,均来自 /config。
概述(AI 翻译)
尊重隐私的AI助手网络搜索——使用操作员控制或可信的SearXNG实例,配合Claude、Cursor等功能。
一台集成 SearXNG API 的 MCP 服务器,赋予 AI 助手网页搜索功能。
✨ 该项目被收录在GitHub MCP注册表中。
快速启动
你需要一个已启用JSON搜索的SearXNG实例。本项目 将MCP客户端连接到SearXNG;但它不会安装SearXNG。使用实例 你操作或信任。从自托管开始 或者如有需要,也可以提供公开实例指南。
选择连接方式:
| 你的设置 | 从这里开始 |
|---|---|
| 客户端在本地启动服务器 | 安装Node.js 22或更高版本,然后使用下面的NPX示例或客户端配方。 |
| 客户端启动一个 Docker 容器 | 在安装中使用 Docker/STDIO 的配方。 |
| 你有一个独立运行的HTTP服务 | 使用客户端的HTTP配方,并使用完整的/mcp URL。 |
| 你需要操作HTTP服务 | 请按照HTTP服务器指南操作。 |
对于使用 mcpServers JSON(如 Claude Desktop)的客户端,请添加:
用你的SearXNG基础URL替换示例URL。其他客户端用不同的
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Quick Start
You need an existing SearXNG instance with JSON search enabled. This project connects an MCP client to SearXNG; it does not install SearXNG. Use an instance you operate or trust. Start with the self-hosted or public-instance guide if needed.
Choose how to connect:
| Your setup | Start here |
|---|---|
| Client starts the server locally | Install Node.js 22 or later, then use the NPX example below or your client recipe. |
| Client starts a Docker container | Use the Docker/STDIO recipe in Installation. |
| You have an independently running HTTP service | Use your client’s HTTP recipe with the full /mcp URL. |
| You need to operate an HTTP service | Follow the HTTP server guide. |
For clients using mcpServers JSON (such as Claude Desktop), add:
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
安装
npx -y mcp-searxng配置
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
"env": { "SEARXNG_URL": "https://search.example.com" }
}
}
}