SearXNG 网络搜索 MCP 服务器

项目简介

本项目 'mcp_server_searXNG' 是一个基于 Model Context Protocol (MCP) 构建的应用后端，专注于提供网络搜索功能。它利用 SearXNG 搜索引擎，为 LLM 客户端提供隐私友好的网络搜索能力。作为一个 MCP 服务器，它可以被集成到任何支持 MCP 协议的 LLM 应用中，扩展模型的功能。

主要功能点

网络搜索: 通过集成的 SearXNG 搜索引擎执行网络信息搜索。
多搜索引擎支持: 利用 SearXNG 的能力，支持多种搜索引擎后端。
搜索类别: 支持多种搜索类别，如网页、图片、新闻等。
灵活参数配置: 允许自定义搜索引擎选择、语言、时间范围、结果数量等搜索参数。
工具集成: 以 MCP 工具的形式提供网络搜索功能，易于 LLM 客户端调用。

安装步骤

安装 Python 包: 使用 pip 命令安装 'mcp-server-searxng' 包。

pip install mcp-server-searxng

如需更新到最新版本，请使用：

pip install --upgrade mcp_server_searxng

服务器配置

要将 'mcp_server_searXNG' 配置为 MCP 服务器，您需要在 MCP 客户端的配置文件中添加以下服务器配置信息。这里的 'command' 和 'args' 字段是客户端连接到此 MCP 服务器的关键。

"mcpServers": {
  "searxng": {
    "command": "python",
    "args": ["-m", "mcp_server_searxng", "--instance-url=https://your-searxng-instance.com"]
  }
}

配置参数说明:

'server name': 'searxng' (服务器名称，客户端用此名称引用该服务器)
'command': 'python' (启动服务器的命令，这里使用 Python 解释器)
'args': 启动参数，包括：
- '-m mcp_server_searxng': 指定以模块方式运行 'mcp_server_searxng'。
- '--instance-url=https://your-searxng-instance.com': SearXNG 实例的 URL。请务必替换 'https://your-searxng-instance.com' 为您实际使用的 SearXNG 实例地址。如果您本地部署了 SearXNG，可以使用 'http://localhost:4000' (默认地址)。

基本使用方法

配置完成后，在 LLM 应用中，您可以通过调用名为 'web_search' 的工具来使用网络搜索功能。

工具调用示例: 以下 JSON 示例展示了如何调用 'web_search' 工具进行搜索。您需要将此 JSON 结构作为参数传递给 LLM 客户端的工具调用接口。

{
  "name": "web_search",
  "arguments": {
    "query": "最新的太空探索进展",
    "categories": ["general"],
    "engines": ["google", "bing"],
    "language": "zh",
    "max_results": 10,
    "time_range": "month"
  }
}

参数说明:

'name': 'web_search' (固定为 'web_search'，表示调用网络搜索工具)
'arguments': 工具参数，包括：
- 'query': (必填) 搜索关键词或查询语句。
- 'categories': (可选) 搜索类别，例如 '["general", "images", "news"]'。默认为 '["general"]'。
- 'engines': (可选) 指定使用的搜索引擎，例如 '["google", "bing", "duckduckgo"]'。默认为 '["google", "bing", "duckduckgo"]'。
- 'language': (可选) 搜索语言代码，例如 '"zh"' (中文), '"en"' (英文)。默认为 '"zh"'。
- 'max_results': (可选) 最大返回结果数量。默认为 '10'。
- 'time_range': (可选) 时间范围过滤，例如 '"day"', '"week"', '"month"', '"year"'。

通过配置和调用 'web_search' 工具，您的 LLM 应用即可利用 SearXNG 网络搜索 MCP 服务器提供的强大搜索能力。

关键词