MCP-searxng

MCP-searxng

site icon
2025.02.22 61
Python搜索服务代理系统集成搜索工具
MCP-searxng 是一个 MCP 服务器,用于通过 searXNG 将代理系统连接到搜索系统。它允许用户通过 searXNG 进行网络搜索,适用于需要集成搜索功能的代理系统。
View on GitHub

Overview

基本能力

产品定位

MCP-searxng 是一个用于连接代理系统和搜索系统的 MCP 服务器,通过 searXNG 提供网络搜索功能。

核心功能

  • 通过 searXNG 进行网络搜索
  • 支持自定义 searXNG 服务器 URL
  • 提供搜索工具,允许用户通过代理系统进行搜索

适用场景

  • 代理系统需要集成网络搜索功能
  • 需要自定义搜索服务器的场景
  • 开发者在构建需要搜索功能的代理系统时

工具列表

  • search(query: str): 通过 searXNG 搜索指定的查询字符串

常见问题解答

  • 如果使用 Claude Desktop,确保在重新运行服务器之前终止进程(通过任务管理器或等效工具)

使用教程

使用依赖

无特别的前置依赖,但需要确保 searXNG 服务器可用。

安装教程

通过 uvx 安装

  1. 配置客户端 JSON 如下:
{
  "mcpServers": {
    "searxng": {
      "command": "uvx", 
      "args": [
        "mcp-searxng"
      ]
    }
  }
}

通过 git clone 安装

  1. 克隆仓库并添加以下 JSON 到 Claude Desktop:
{
  "mcpServers": {
    "searxng": {
      "command": "uv", 
      "args": [
        "--project",
        "/absoloute/path/to/MCP-searxng/",
        "run",
        "/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
      ]
    }
  }
}
  1. 修改路径以匹配你的环境

自定义 SearXNG URL

  1. 设置环境变量 SEARXNG_URL 为 searxng 服务器的 URL(默认为 http://localhost:8080
  2. 运行你的 MCP 客户端,即可通过 searxng 搜索网络

调试方式

无特别调试步骤,确保 searXNG 服务器可用且环境变量设置正确。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。