🚀 SearXNG MCP 服务器
SearXNG MCP 服务器是一个集成到 SearXNG 的 MCP 服务器实现，它提供了隐私导向的元搜索功能，能结合多个搜索引擎的结果，为用户带来更全面、安全的搜索体验。
🚀 快速开始
若要使用 SearXNG MCP 服务器，你需要一个本地运行的 SearXNG 实例。下面是使用 Docker 运行 SearXNG 的快速开始步骤：
# 创建配置目录
mkdir -p searxng
# 创建配置文件
tee searxng/settings.yml << EOF
use_default_settings: true
server:
bind_address: "0.0.0.0"
secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE" # 生成一个随机密钥
port: 8080
search:
safe_search: 0
formats:
- html
- json
engines:
- name: google
engine: google
shortcut: g
- name: duckduckgo
engine: duckduckgo
shortcut: d
- name: bing
engine: bing
shortcut: b
server.limiter: false
EOF
# 启动容器
docker run -d \
--name searxng \
-p 8080:8080 \
-v $(pwd)/searxng:/etc/searxng \
searxng/searx:latest
✨ 主要特性
- 元搜索：结合多个搜索引擎的结果，让搜索结果更全面。
- 隐私导向：无跟踪，无用户画像，充分保护用户隐私。
- 多类别支持：支持通用、新闻、科学、文件、图片、视频等多种搜索类别。
- 语言支持：可以指定语言搜索，也支持搜索所有语言的内容。
- 时间范围过滤：可按天、周、月、年筛选搜索结果。
- 安全搜索：提供三个级别的安全搜索过滤（无、中等、严格）。
- 备用支持：多个 SearXNG 实例确保服务的可靠性。
📦 安装指南
使用以下命令进行全局安装：
npm install -g @kevinwatt/mcp-server-searxng
💻 使用示例
基础用法
直接运行 MCP 服务器：
mcp-server-searxng
高级用法
与 Dive Desktop 结合使用：
- 在 Dive Desktop 中点击 "+ 添加 MCP 服务器"。
- 复制并粘贴以下配置：
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/mcp-server-searxng"
]
}
}
}
- 点击"保存"以安装 MCP 服务器。
📚 详细文档
web_search
- 功能：执行多个引擎的元搜索。
- 输入参数：
query(字符串)：搜索词。page(数字，可选)：页码（默认：1）。language(字符串，可选)：语言代码（例如 'en'，'all'，默认：'all'）。categories(数组，可选)：搜索类别（默认：['general']），可用值："general", "news", "science", "files", "images", "videos", "music", "social media", "it"。time_range(字符串，可选)：时间过滤器（天/周/月/年）。safesearch(数字，可选)：安全搜索级别（0: 无，1: 中等，2: 严格，默认：1）。
🔧 技术细节
开发步骤
git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start
配置文件说明
use_default_settings: true：使用默认设置，无需额外配置。bind_address: "0.0.0.0"：允许外部访问。secret_key：用于 API 认证，请替换为随机字符串。port: 8080：指定端口。
环境变量
docker run -d \
--name searxng \
-p 8080:8080 \
-e SEARXNG_BEANSTALKD=redis://beanstalkd:1327 \
-v $(pwd)/searxng:/etc/searxng \
searxng/searx:latest
多实例支持
在 MCP 服务器中配置多个 SearXNG 实例：
{
"mcpServers": {
"searxng": {
"name": "searxng",
"command": "npx",
"args": [
"-y",
// 后续内容可根据实际情况补充
]
}
}
}
📄 许可证
此 MCP 服务器根据 MIT License 许可。有关详细信息，请参阅 LICENSE 文件。