搜索引擎集成服务

一个为AI助手提供网络搜索和页面阅读能力的MCP服务器,基于用户控制的SearXNG实例。

  • by arisjulio
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 arisjulio/searxng-mcp-ts

使用说明

SearXNG MCP服务器

MCP服务器为AI助手(Claude、Cursor等)提供搜索网络和阅读页面的能力,由 SearXNG 你控制的实例。

先决条件

  • Docker或Podman(与Docker Compose兼容)
  • 启用JSON格式的正在运行的SearXNG实例(请参见 SearXNG文档)

设置

1.克隆仓库

git clone https://github.com/arisjulio/searxng-mcp
cd searxng-mcp

2.配置环境

cp .env.example .env

编辑 .env.

3.启动服务器

# With Docker
docker compose up -d

# With Podman
podman compose up -d

4.验证它是否正在运行

curl http://localhost:${PORT}/health
# {"status":"ok"}

工具

web_search

通过SearXNG搜索网络。返回标题、URL、引擎源代码和摘要。

参数 类型 必填 默认 说明
query string yes -- 搜索查询。支持特定于引擎的语法(例如。 site:github.com SearXNG).
language string 否 es 结果的语言代码(例如。 en, es).
engines string[] 否 ["brave", "duckduckgo", "startpage"] 要查询的引擎。选项: brave, duckduckgo, google, startpage, wikidata, wikipedia, yahoo. 注: 必须在SearXNG实例中启用所有选定的引擎。
time_range string 否 month 按新旧程度过滤。选项: day, month, year.
max_results 编号 否 20 要返回的最大结果数。

SearXNG发动机要求

可用的发动机 engines 参数取决于SearXNG实例中配置的内容。如果选择了一个引擎但未在服务器上启用,则使用该引擎的搜索将自动失败或不返回任何结果。请参阅SearXNG实例的设置,以确认哪些引擎可用。

网络安全

此MCP服务器专为可信/专用网络而设计。 它不应该直接暴露在公共互联网上。服务器没有内置的身份验证或访问控制——任何可以访问服务器的客户端都可以通过您的SearXNG实例执行搜索。

如果您需要远程访问此服务器,请使用VPN、SSH隧道或前面有身份验证的反向代理。

连接您的MCP客户端

服务器使用 可流式HTTP传输 上 POST /mcp.