搜索协议服务

一个连接AI助手和隐私保护元搜索引擎SearXNG的模型上下文协议(MCP)服务,提供多种搜索功能和传输支持。

  • by BrandonStudio
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BrandonStudio/SearXNG-MCP

使用说明

SearXNG MCP

模型上下文协议(MCP)服务器,在AI助手和 SearXNG,一个尊重隐私的元搜索引擎。

特性

  • 搜索工具:通过SearXNG进行网络搜索,并完全支持:

    • 多个搜索类别(一般、图像、视频、新闻、音乐、文件等)
    • 特定发动机选择
    • 语言过滤
    • 分页
    • 时间范围过滤
    • 安全搜索设置
  • 发动机发现:列出您的SearXNG实例支持的所有可用搜索引擎

  • 运输支持:

先决条件

您应该在SearXNG实例中启用JSON模型。 找到 search.formats 您的配置 settings.yml 包括 json:

search:
  formats:
    - html
    - json

配置

可以使用环境变量配置服务器:

变量 描述 默认值
SEARXNG_URL SearXNG实例的URL http://localhost:8080
PORT HTTP传输端口 3000
TRANSPORT_MODE 运输方式: http 或 stdio http

用法

HTTP传输(流式HTTP)

# Start the server
TRANSPORT_MODE=http SEARXNG_URL=https://your-searxng-instance.com npm start

# The server will listen on http://localhost:3000/mcp

标准运输

# Start with stdio transport
SEARXNG_URL=https://your-searxng-instance.com npm start

MCP客户端配置

对于Claude Desktop或其他MCP兼容客户端,请在配置中添加:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@bs-mcps/searxng"
      ],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.com",
      }
    }
  }
}

Cloudflare工作者传输

您可以将MCP服务器部署为Cloudflare Worker。

要部署,您可以分叉此存储库,然后创建一个链接到您的分叉的新Worker。

或者,您只需单击下面的按钮即可直接部署到Cloudflare:

所需的环境变量

变量 描述
SEARXNG_URL SearXNG实例的URL

可用工具

工具 说明
search 使用SearXNG进行网络搜索
get_engines 获取SearXNG实例支持的所有可用搜索引擎

搜索

使用SearXNG进行网络搜索。

参数:

  • query (必填):搜索查询
  • categories:类别数组(例如。, ["general", "images"])
  • engines:特定引擎阵列(例如。, ["google", "duckduckgo"])
  • language:语言代码(例如。, "en")
  • pageno:分页页码
  • time_range:时间过滤器("day", "week", "month", "year")
  • safesearch:安全搜索级别(0, 1, 2)

get_engines

获取SearXNG实例支持的所有可用搜索引擎。

无需参数。

版权声明

版权所有2025-2026 BrandonStudio

根据Apache许可证2.0版(“许可证”)许可; 除非遵守许可证,否则您不得使用此文件。 您可以在以下网址获得许可证副本

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意,否则软件 根据许可证分发的内容按“原样”分发, 无任何明示或暗示的保证或条件。 请参阅许可证,了解管理权限和 许可证下的限制。