JinDaGe - mcp_server_searXNG MCP Details

article

README

🚀 mcp_server_searXNG

mcp_server_searXNG 是基于 MCP 技术的网络搜索功能服务器，借助 SearXNG 搜索引擎，为用户提供隐私友好的网络搜索服务。

🚀 快速开始

mcp_server_searXNG 是一款强大的网络搜索服务器，它利用 MCP 技术和 SearXNG 搜索引擎，让用户能够在保护隐私的前提下进行高效搜索。

✨ 主要特性

多引擎搜索：可通过多个搜索引擎进行网络搜索，满足多样化的搜索需求。
多类别支持：支持多种搜索类别，如一般、图片、新闻等。
自定义选择：允许用户自定义搜索引擎，灵活控制搜索范围。
语言筛选：支持语言筛选，方便不同语言用户使用。
时间过滤：提供时间范围过滤功能，精准定位搜索结果。
结果数量控制：可控制搜索结果的数量，避免信息过载。

📦 安装指南

使用 pip 安装

# 安装
pip install mcp-server-searxng==0.2

# 获取最新版本
pip install --upgrade mcp_server_searxng

💻 使用示例

基础用法

配置为 MCP 服务

在您的 MCP 配置中添加如下内容：

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

高级用法

调用示例

{
  "name": "web_search",
  "arguments": {
    "query": "气候变化研究",
    "categories": ["general"],
    "engines": ["google"],
    "language": "zh",
    "max_results": 15,
    "time_range": "month"
  }
}

📚 详细文档

可用工具

web_search - 使用 SearXNG 执行网络搜索
- 必需参数：
  - query (string)：搜索查询内容
- 可选参数：
  - categories (array)：搜索类别，例如 ['general', 'images', 'news']
  - engines (array)：搜索引擎，例如 ['google', 'bing', 'duckduckgo']
  - language (string)：搜索语言代码，默认为 "zh"
  - max_results (integer)：最大结果数量，默认为 10
  - time_range (string)：时间范围过滤 ('day', 'week', 'month', 'year')

调试

您可以使用 MCP inspector 来调试服务器：

npx @modelcontextprotocol/inspector python -m mcp_server_searxng

实际效果展示

| 测试类型 | 详情 | | ---- | ---- | | inspector 的测试 | - | | 基于我自己 chat_mcp 的测试 | - |

📄 许可证

mcp_server_searXNG 使用 MIT 许可证。这意味着您可以自由使用、修改和分发此软件，但需遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

mcp_server_searXNG