mcp-searxng

🚀 SearXNG MCP 服务器

SearXNG MCP 服务器是一个 MCP 服务器 实现，它集成了 SearXNG API，能够为用户提供强大的网络搜索功能。

🚀 快速开始

为了让 SearXNG MCP 服务器正常工作，您需要设置 SEARXNG_URL 环境变量，该变量将告诉服务器如何与 SearXNG 实例进行通信。设置方法如下：

SEARXNG_URL=http://localhost:8080

✨ 主要特性

• 网络搜索：支持一般查询、新闻、文章，带分页功能。
• 分页：控制要获取的结果页数（从 1 开始）。
• 时间过滤：按时间段筛选结果（日、月、年）。
• 语言选择：按语言代码筛选结果（例如："en", "fr", "de"）或设置为 "all"。
• 安全搜索：控制内容过滤级别（0: 无，1: 中等，2: 严格）。

📦 安装指南

使用 NPM 安装

您可以使用 Node Package Manager (NPM) 来安装和运行 MCP 服务器：

npm install -g searxng-mcp-server
searxng-mcp-server start

使用 NPX 运行

您也可以直接使用 NPX 来运行 MCP 服务器，无需预先安装：

npx searxng-mcp-server start

使用 Docker 安装

要使用 Docker 安装和运行 MCP 服务器，请执行以下命令：

docker pull searxng/mcp-server:latest
docker run -e SEARXNG_URL=http://localhost:8080 -p 8000:8000 searxng/mcp-server:latest

在 Claude Desktop 上配置

要在 Claude Desktop 上配置 MCP 服务器，请按照以下步骤操作：

1. 打开 Claude Desktop。
2. 转到 设置 > 扩展。
3. 搜索并安装 "SearXNG MCP Server" 扩展。
4. 安装完成后，重启 Claude Desktop。

📚 详细文档

工具介绍

searxng_web_search

• 带分页执行网络搜索
• 输入：
  • query (字符串)：搜索查询。此字符串会传递给外部搜索引擎。
  • pageno (数字，可选)：搜索的页码，从 1 开始（默认为 1）。
  • time_range (字符串，可选)：按时间段筛选结果，可选值包括："day", "month", "year"（默认：无）。
  • language (字符串，可选)：结果的语言代码（例如："en", "fr", "de"）或 "all"（默认：所有语言）。
  • safesearch (数字，可选)：安全搜索过滤级别（0: 无，1: 中等，2: 严格）（默认：实例设置）。

web_url_read

• 从 URL 获取并转换内容为 Markdown 格式
• 输入：
  • url (字符串)：要获取和处理的 URL

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。