使用说明
SearXNG MCP
模型上下文协议(MCP)服务器,在AI助手和 SearXNG,一个尊重隐私的元搜索引擎。
特性
-
搜索工具:通过SearXNG进行网络搜索,并完全支持:
- 多个搜索类别(一般、图像、视频、新闻、音乐、文件等)
- 特定发动机选择
- 语言过滤
- 分页
- 时间范围过滤
- 安全搜索设置
-
发动机发现:列出您的SearXNG实例支持的所有可用搜索引擎
-
运输支持:
- 可流式HTTP传输(建议用于web集成)
- 标准I/O传输(用于CLI集成)
- Cloudflare Worker传输
先决条件
您应该在SearXNG实例中启用JSON模型。
找到 search.formats 您的配置 settings.yml 包括 json:
search:
formats:
- html
- json
配置
可以使用环境变量配置服务器:
| 变量 | 描述 | 默认值 |
|---|---|---|
SEARXNG_URL |
SearXNG实例的URL | http://localhost:8080 |
PORT |
HTTP传输端口 | 3000 |
TRANSPORT_MODE |
运输方式: http 或 stdio |
http |
用法
HTTP传输(流式HTTP)
# Start the server
TRANSPORT_MODE=http SEARXNG_URL=https://your-searxng-instance.com npm start
# The server will listen on http://localhost:3000/mcp
标准运输
# Start with stdio transport
SEARXNG_URL=https://your-searxng-instance.com npm start
MCP客户端配置
对于Claude Desktop或其他MCP兼容客户端,请在配置中添加:
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"@bs-mcps/searxng"
],
"env": {
"SEARXNG_URL": "https://your-searxng-instance.com",
}
}
}
}
Cloudflare工作者传输
您可以将MCP服务器部署为Cloudflare Worker。
要部署,您可以分叉此存储库,然后创建一个链接到您的分叉的新Worker。
或者,您只需单击下面的按钮即可直接部署到Cloudflare:
所需的环境变量
| 变量 | 描述 |
|---|---|
SEARXNG_URL |
SearXNG实例的URL |
可用工具
| 工具 | 说明 |
|---|---|
search |
使用SearXNG进行网络搜索 |
get_engines |
获取SearXNG实例支持的所有可用搜索引擎 |
搜索
使用SearXNG进行网络搜索。
参数:
query(必填):搜索查询categories:类别数组(例如。,["general", "images"])engines:特定引擎阵列(例如。,["google", "duckduckgo"])language:语言代码(例如。,"en")pageno:分页页码time_range:时间过滤器("day","week","month","year")safesearch:安全搜索级别(0,1,2)
get_engines
获取SearXNG实例支持的所有可用搜索引擎。
无需参数。
版权声明
版权所有2025-2026 BrandonStudio
根据Apache许可证2.0版(“许可证”)许可; 除非遵守许可证,否则您不得使用此文件。 您可以在以下网址获得许可证副本
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则软件 根据许可证分发的内容按“原样”分发, 无任何明示或暗示的保证或条件。 请参阅许可证,了解管理权限和 许可证下的限制。