SearXNG MCP 服务器

一个实现了 MCP 服务器 的项目，集成了 SearXNG API，提供了网页搜索功能。

功能

• 网页搜索：通用查询、新闻、文章，并支持分页。
• 分页：控制检索结果的页数。
• 时间过滤：按时间范围（天、月、年）过滤结果。
• 语言选择：按首选语言过滤结果。
• 安全搜索：控制搜索结果的内容过滤级别。

工具

• searxng_web_search

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

• web_url_read

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

配置

设置 SEARXNG_URL

1. 从 公共实例列表 中选择一个 SearxNG 实例，或者使用你的本地环境。
2. 将 SEARXNG_URL 环境变量设置为实例 URL。
3. 默认的 SEARXNG_URL 值为 http://localhost:8080。

使用身份验证

如果你使用的是受密码保护的 SearxNG 实例，可以设置用户名和密码进行 HTTP 基本认证：

• 将 AUTH_USERNAME 环境变量设置为你的用户名
• 将 AUTH_PASSWORD 环境变量设置为你的密码

与 Claude Desktop 一起使用

通过 Smithery 安装

要通过 Smithery 自动安装 SearXNG 服务器以供 Claude Desktop 使用：

bash
npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude

NPX

json
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}

NPM

bash
npm install -g mcp-searxng

然后在你的 MCP 配置文件中：

json
{
"mcpServers": {
"searxng": {
"command": "mcp-searxng",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}

Docker

使用 Docker Hub 上的预构建镜像

bash
docker pull isokoliuk/mcp-searxng:latest

在你的 claude_desktop_config.json 文件中添加以下内容：

json
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"isokoliuk/mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}

本地构建

bash
docker build -t mcp-searxng:latest -f Dockerfile .

使用

在你的 claude_desktop_config.json 文件中添加以下内容：

json
{
"mcpServers": {
"searxng": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"mcp-searxng:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}## 运行评估

evals 包加载一个 mcp 客户端，然后运行 index.ts 文件，因此在测试之间无需重新构建。您可以在此处查看完整文档这里。

bash
SEARXNG_URL=SEARXNG_URL OPENAI_API_KEY=your-key npx mcp-eval evals.ts index.ts

许可证

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