SearXNG MCP服务器
MCP服务器为AI助手(Claude、Cursor等)提供搜索网络和阅读页面的能力,由 SearXNG 你控制的实例。
先决条件
- Docker或Podman(与Docker Compose兼容)
- 启用JSON格式的正在运行的SearXNG实例(请参见 SearXNG文档)
设置
1.克隆仓库
git clone https://github.com/arisjulio/searxng-mcp
cd searxng-mcp2.配置环境
cp .env.example .env编辑 .env.
3.启动服务器
# With Docker
docker compose up -d
# With Podman
podman compose up -d4.验证它是否正在运行
curl http://localhost:${PORT}/health
# {"status":"ok"}工具
web_search
通过SearXNG搜索网络。返回标题、URL、引擎源代码和摘要。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
query | string | yes | -- | 搜索查询。支持特定于引擎的语法(例如。 site:github.com SearXNG). |
language | string | 否 | es | 结果的语言代码(例如。 en, es). |
engines | string\[\] | 否 | ["brave", "duckduckgo", "startpage"] | 要查询的引擎。选项: brave, duckduckgo, google, startpage, wikidata, wikipedia, yahoo. 注: 必须在SearXNG实例中启用所有选定的引擎。 |
time_range | string | 否 | month | 按新旧程度过滤。选项: day, month, year. |
max_results | 编号 | 否 | 20 | 要返回的最大结果数。 |
SearXNG发动机要求
可用的发动机 engines 参数取决于SearXNG实例中配置的内容。如果选择了一个引擎但未在服务器上启用,则使用该引擎的搜索将自动失败或不返回任何结果。请参阅SearXNG实例的设置,以确认哪些引擎可用。
网络安全
此MCP服务器专为可信/专用网络而设计。 它不应该直接暴露在公共互联网上。服务器没有内置的身份验证或访问控制——任何可以访问服务器的客户端都可以通过您的SearXNG实例执行搜索。
如果您需要远程访问此服务器,请使用VPN、SSH隧道或前面有身份验证的反向代理。
连接您的MCP客户端
服务器使用 可流式HTTP传输 上 POST /mcp.
