Mcp_server_searXNG

🚀 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

实际效果展示

📄 许可证

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