mcp-searxng

mcp-searxng

site icon
2025.03.30 1
Python元搜索引擎隐私保护自托管搜索工具
mcp-searxng 是一个基于 SearXNG 开源元搜索引擎的 MCP 服务器,旨在为 AI 代理提供外部信息搜索能力。通过整合多个搜索引擎的结果,SearXNG 能够提供更全面和隐私保护的搜索体验。该服务支持自托管或使用社区提供的站点,适用于需要隐私保护和高效搜索的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-searxng 是一个为 AI 代理设计的 MCP 服务器,通过 SearXNG 开源元搜索引擎,允许 AI 代理搜索外部信息。

核心功能

  1. 元搜索引擎集成:整合多个搜索引擎的结果,提供更全面的搜索体验。
  2. 隐私保护:不跟踪用户搜索行为,确保隐私安全。
  3. 自托管支持:支持自托管 SearXNG 服务,便于企业控制隐私和安全。
  4. Markdown 格式化:使用 Microsoft 的 markdownify 将网页内容提取为 Markdown 格式文本。

适用场景

  1. AI 代理需要获取外部信息时。
  2. 企业需要隐私保护的搜索解决方案。
  3. 开发者需要自托管元搜索引擎的场景。

工具列表

  1. web_search:用于执行关键词搜索。
  2. web_url_read:用于读取指定 URL 的网页内容。

常见问题解答

  1. 为什么使用 SearXNG?:SearXNG 整合多个搜索引擎的结果,提供更全面和隐私保护的搜索体验。
  2. 如何自托管 SearXNG?:参考 SearXNG 官方文档自托管教程

使用教程

使用依赖

  1. 安装 Docker: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 安装 Node.js: bash curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash \. "$HOME/.nvm/nvm.sh" nvm install 22

安装教程

  1. 下载源代码: bash git clone https://github.com/erhwenkuo/mcp-searxng.git cd mcp-searxng uv sync
  2. 启动 SearXNG 服务: bash cd searxng-docker docker compose up -d
  3. 启动 MCP-SEARXNG 服务: bash uv run server.py --searxng_url="http://localhost:8888"

调试方式

  1. 启动 MCP Inspector: bash npx @modelcontextprotocol/inspector
  2. 在浏览器中打开 http://localhost:5173,选择 SSE 传输类型,输入 MCP 服务器地址 http://localhost:5488/sse,点击 Connect
  3. 使用 web_searchweb_url_read 工具进行测试。

许可证

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