SearXNG 模型上下文协议服务器

这是一个用于通过SearXNG搜索引擎与语言模型进行交互的模型上下文协议（MCP）服务器。

描述

该服务器使语言模型能够使用模型上下文协议标准通过SearXNG执行网络搜索。它提供了一个干净的接口，使语言模型可以向SearXNG发送搜索查询并接收格式化的结果。

安装

# 克隆仓库
git clone https://github.com/aeon-seraph/searxng-mcp.git
cd searxng-mcp

# 安装依赖
npm install

# 构建项目
npm run build

要求

• Node.js 16+
• 运行中的SearXNG实例（默认在http://localhost:8888）

使用方法

# 运行服务器
node build/index.js

服务器将在标准I/O上运行，使其适合与兼容MCP的语言模型集成。

配置

服务器可以通过环境变量进行配置：

变量	描述	默认值
SEARXNG_PROTOCOL	使用的协议（http/https）	http
SEARXNG_HOST	SearXNG主机	localhost
SEARXNG_PORT	SearXNG端口	8888
CACHE_TTL	缓存生存时间（毫秒）	600000（10分钟）
MAX_CACHE_SIZE	最大缓存查询数	100

示例：

SEARXNG_HOST=mysearx.example.com SEARXNG_PORT=443 SEARXNG_PROTOCOL=https node build/index.js

Docker

项目包含一个Dockerfile，便于部署：

# 构建Docker镜像
docker build -t searxng-mcp .

# 运行容器
docker run -e SEARXNG_HOST=mysearx.example.com -e SEARXNG_PROTOCOL=https searxng-mcp

搜索参数

搜索功能支持以下参数：

• query（必需）：搜索查询字符串
• categories：逗号分隔的搜索类别列表
• pageno：搜索页码（默认：1）
• time_range：结果的时间范围（"day"，"week"，"month"，"year"）
• raw_json：返回原始JSON响应而不是格式化文本（默认：false）

许可证

MIT