SearXNG MCP Server

这是一个 MCP server 实现，集成了 SearXNG API，旨在提供 Web 搜索功能。

特性

• Web 搜索：支持通用查询、新闻、文章，并提供分页功能。
• URL 内容读取：支持高级内容提取，包括分页、章节过滤和标题提取。
• 智能缓存：URL 内容通过 TTL（生存时间）机制进行缓存，以提高性能并减少冗余请求。
• 分页：可控制检索搜索结果的特定页面。
• 时间过滤：可按时间范围（日、月、年）过滤结果。
• 语言选择：可按首选语言过滤结果。
• 安全搜索：可控制搜索结果的内容过滤级别。

工具

• searxng_web_search

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

• web_url_read

  • 读取并将 URL 内容转换为 Markdown 格式，支持高级内容提取选项
  • 输入参数：
    • url (string): 要抓取和处理的 URL
    • startChar (number, 可选): 内容提取的起始字符位置（默认：0）
    • maxLength (number, 可选): 返回的最大字符数
    • section (string, 可选): 提取特定标题下的内容（根据标题文本搜索）
    • paragraphRange (string, 可选): 返回特定段落范围（例如 '1-5', '3', '10-'）
    • readHeadings (boolean, 可选): 仅返回标题列表而非全文

配置

环境变量

必选

• SEARXNG_URL: SearXNG 实例 URL（默认：http://localhost:8080）
  • 格式：://[:]
  • 示例：https://search.example.com

可选

• AUTH_USERNAME / AUTH_PASSWORD: 用于 searxng_web_search 的 HTTP Basic Auth 凭据（适用于受密码保护的 SearXNG 实例）
• USER_AGENT: searxng_web_search 和 web_url_read 共用的全局默认 User-Agent 请求头（例如 MyBot/1.0）
• URL_READER_USER_AGENT: 专门用于 web_url_read 工具的自定义 User-Agent（会覆盖针对 URL 读取请求的 USER_AGENT）
• HTTP_PROXY / HTTPS_PROXY: 用于路由流量的全局代理 URL（作为两个接口的后备）
  • 格式：http://[username:password@]proxy.host:port
• NO_PROXY: 以逗号分隔的绕过列表（例如 localhost,.internal,example.com）

接口专用代理（可选）

• SEARCH_HTTP_PROXY / SEARCH_HTTPS_PROXY: 仅用于 searxng_web_search 工具的代理
• URL_READER_HTTP_PROXY / URL_READER_HTTPS_PROXY: 仅用于 web_url_read 工具的代理
  • 对于各自的接口，这些设置的优先级高于 HTTP_PROXY/HTTPS_PROXY

高级配置

# 为搜索和 URL 读取设置不同的代理
SEARCH_HTTP_PROXY=http://search-proxy:8080
URL_READER_HTTP_PROXY=http://reader-proxy:8080

# 为 URL 读取器设置自定义 user_agent
URL_READER_USER_AGENT="Mozilla/5.0 (compatible; Bot/1.0)"

安装与配置

NPX

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

完整配置示例（包含所有选项）：

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL",
        "AUTH_USERNAME": "your_username",
        "AUTH_PASSWORD": "your_password",
        "USER_AGENT": "MyBot/1.0",
        "URL_READER_USER_AGENT": "Mozilla/5.0 (compatible; MyBot/1.0)",
        "SEARCH_HTTP_PROXY": "http://search-proxy.company.com:8080",
        "URL_READER_HTTP_PROXY": "http://reader-proxy.company.com:8080",
        "HTTP_PROXY": "http://global-proxy.company.com:8080",
        "HTTPS_PROXY": "http://global-proxy.company.com:8080",
        "NO_PROXY": "localhost,127.0.0.1,.local,.internal"
      }
    }
  }
}

注意： 以上环境变量可以根据需求灵活组合使用。