返回 MCP 目录
public公开dns本地运行

SearXNG

一个为SearXNG搜索引擎提供语言模型接口的MCP服务器。

article

README

🚀 SearXNG 模型上下文协议服务器

本项目是一个用于将语言模型与 SearXNG 搜索引擎接口连接的 Model Context Protocol(MCP)服务器。它能让语言模型借助 SearXNG 开展网络搜索,为语言模型提供了一个简洁的接口,可向 SearXNG 发送搜索查询并接收格式化的结果。

🚀 快速开始

此服务器使语言模型能够通过 SearXNG 进行网络搜索,使用 Model Context Protocol 标准。它为语言模型提供了一个干净的接口,用于向 SearXNG 发送搜索查询并接收格式化的结果。

📦 安装指南

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

# 安装依赖项
npm install

# 构建项目
npm run build

✨ 主要特性

  • 支持语言模型通过 SearXNG 进行网络搜索。
  • 提供干净的接口,便于发送搜索查询和接收格式化结果。
  • 支持通过环境变量进行灵活配置。
  • 支持 Docker 部署。

💻 使用示例

基础用法

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

该服务器将在标准输入输出上运行,使其适合与 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 部署

# 构建 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)

🔧 技术细节

需求

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

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端