基本能力
产品定位
SearXNG MCP Server 是一个为 AI 助手提供网络搜索能力的中间件服务,通过 SearXNG 实现隐私保护的搜索功能。
核心功能
- 零配置设置:自动从 SearX.space 选择随机公共实例,无需额外部署
- 私有实例支持:支持连接到自托管的 SearXNG 实例,并可配置基本认证
- 可定制的搜索参数:支持多种搜索参数,如语言、时间范围、类别等
- 隐私优先:搜索结果注重隐私保护
- Markdown 格式的搜索结果:返回格式化的搜索结果
- 合理的默认值:所有参数都有合理的默认值
适用场景
- AI 助手需要执行网络搜索的场景
- 需要隐私保护的搜索应用
- 需要集成多个搜索引擎的应用
工具列表
- searxngsearch:使用 SearXNG 进行网络搜索的工具,支持多种参数配置
常见问题解答
- 公共实例可能不可用:可能会返回 "Request failed with status code 429" 错误
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm (v7 或更高版本)
- 访问 SearXNG 实例(自托管或公共实例)
安装教程
```bash
克隆仓库
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp
安装依赖
npm install
构建项目
npm run build
```
调试方式
```bash
如果全局安装
searxngmcp
如果从源代码安装
node build/index.js
```
配置
可以通过环境变量配置 SearXNG MCP 服务器:
- SEARXNG_URL
:SearXNG 实例的 URL
- USE_RANDOM_INSTANCE
:设置为 "false" 以禁用随机实例选择
- SEARXNG_USERNAME
:私有实例的用户名
- SEARXNG_PASSWORD
:私有实例的密码
在项目根目录的 .env
文件中设置这些变量:
SEARXNG_URL=https://searx.example.com
SEARXNG_USERNAME=your_username
SEARXNG_PASSWORD=your_password