SearXNG Model Context Protocol Server
2025.03.08
1
TypeScript搜索引擎集成语言模型接口搜索工具
SearXNG Model Context Protocol Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于将语言模型与 SearXNG 搜索引擎进行交互。它提供了一个简洁的接口，使语言模型能够通过 SearXNG 发送搜索查询并接收格式化的结果。
View on GitHub
Overview
基本能力
产品定位
SearXNG-MCP 是一个中间件服务器，旨在桥接语言模型和 SearXNG 搜索引擎，提供高效的搜索功能集成。
核心功能
- 通过 MCP 标准接口与语言模型交互
- 支持向 SearXNG 发送搜索查询并接收格式化结果
- 可配置的搜索参数（如分类、时间范围等）
- 内置缓存机制（可配置 TTL 和最大缓存大小）
- 支持 Docker 容器化部署
适用场景
- 语言模型需要实时网络搜索功能
- 需要将 SearXNG 搜索集成到 AI 应用中的场景
- 需要可配置、可扩展的搜索解决方案
工具列表
- Node.js 运行时环境
- Docker（可选，用于容器化部署）
常见问题解答
- 如何更改 SearXNG 实例地址？ 通过环境变量 SEARXNG_HOST、SEARXNG_PORT 和 SEARXNG_PROTOCOL 配置
- 如何调整缓存设置？ 通过 CACHE_TTL 和 MAX_CACHE_SIZE 环境变量配置
使用教程
使用依赖
- Node.js 16+
- 运行中的 SearXNG 实例（默认地址：http://localhost:8888）
安装教程
# 克隆仓库
git clone https://github.com/aeon-seraph/searxng-mcp.git
cd searxng-mcp
# 安装依赖
npm install
# 构建项目
npm run build
调试方式
# 运行服务器
node build/index.js
# 使用自定义配置运行示例
SEARXNG_HOST=mysearx.example.com SEARXNG_PORT=443 SEARXNG_PROTOCOL=https node build/index.js
Docker 部署
# 构建 Docker 镜像
docker build -t searxng-mcp .
# 运行容器
docker run -e SEARXNG_HOST=mysearx.example.com -e SEARXNG_PROTOCOL=https searxng-mcp