🚀 SearXNG + Puppeteer MCP 服务器
这是一个 MCP 服务器 实现，它集成了 SearXNG API，具备强大的网络搜索能力，并使用 @missionsquad/puppeteer-scraper 来读取和处理实时网络内容。
该服务器是 Mission Squad 生态系统的一个组件，旨在提供可靠的、自主的网络浏览和信息检索服务。
✨ 主要特性
- 网络搜索：执行常规查询、查找新闻，并通过强大的过滤功能访问文章。
- URL 内容读取：抓取并处理任何 URL 的内容，返回简洁的文本。
- 分页功能：控制检索搜索结果的页码。
- 时间过滤：按时间范围（天、月、年）过滤搜索结果。
- 语言选择：按首选语言过滤结果。
- 安全搜索：控制搜索结果的内容过滤级别。
🛠️ 工具
web_search
使用配置好的 SearXNG 实例执行网络搜索。
输入参数：
query（字符串，必填）：搜索查询内容。pageno（数字，可选）：要检索的搜索结果页码，从 1 开始，默认为1。count（数字，可选）：每页返回的结果数量，默认为10。time_range（字符串，可选）：按时间范围过滤结果，有效选项为："day"、"month"、"year"。language（字符串，可选）：结果的语言代码（例如，"en"、"fr"、"de"），默认为实例的设置。safesearch（字符串，可选）：安全搜索过滤级别，有效选项为："0"（无）、"1"（中等）、"2"（严格），默认为实例的设置。
get_url_content
读取给定 URL 的内容，使用 Puppeteer 进行处理，并返回文本内容。
输入参数：
url（字符串，必填）：要获取和处理的 URL。
📦 安装指南
设置 SEARXNG_URL
此服务器需要一个正在运行的 SearXNG 实例。
- 从 公共实例列表 中选择一个 SearxNG 实例，或者自行部署。
- 将
SEARXNG_URL环境变量设置为该实例的 URL。 - 如果未设置，服务器默认使用
http://localhost:8080。
使用 Docker 运行 SearXNG
你可以使用 Docker 在本地运行 SearXNG。
Docker 运行命令：
docker run --rm -d -p 8080:8080 -v ${PWD}/searxng:/etc/searxng:rw --name searxng searxng/searxng:latest
此命令将启动一个 SearXNG 容器，并将其映射到本地机器的 8080 端口。
Docker Compose 示例：
创建一个 docker-compose.yml 文件，内容如下：
services:
searxng:
container_name: searxng
image: docker.io/searxng/searxng:latest
restart: unless-stopped
ports:
- 8081:8080
volumes:
- ./searxng:/etc/searxng:rw
environment:
- SEARXNG_BASE_URL=https://${SEARXNG_HOSTNAME:-localhost}/
- UWSGI_WORKERS=${SEARXNG_UWSGI_WORKERS:-4}
- UWSGI_THREADS=${SEARXNG_UWSGI_THREADS:-4}
cap_drop:
- ALL
cap_add:
- CHOWN
- SETGID
- SETUID
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "2"
运行 docker-compose up -d 启动服务。请注意，此示例将服务映射到 8081 端口。
💻 使用示例
NPX
直接运行服务器进行开发或测试：
{
"mcpServers": {
"searxng-puppeteer": {
"command": "npx",
"args": ["-y", "@missionsquad/mcp-searxng-puppeteer"],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
NPM
全局安装该软件包：
npm install -g @missionsquad/mcp-searxng-puppeteer
然后在你的 MCP 客户端中进行配置：
{
"mcpServers": {
"searxng-puppeteer": {
"command": "mcp-searxng-puppeteer",
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
Docker
Docker 镜像即将在 Docker Hub 上提供。若要在本地构建：
docker build -t missionsquad/mcp-searxng-puppeteer:latest .
然后，将其添加到你的 MCP 客户端配置中：
{
"mcpServers": {
"searxng-puppeteer": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"missionsquad/mcp-searxng-puppeteer:latest"
],
"env": {
"SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
}
}
}
}
🔍 在 Mission Squad 上试用
你可以在 Mission Squad 平台上测试 @missionsquad/mcp-searxng-puppeteer 服务器和其他 MCP 服务器。Mission Squad 是一个自主人工智能平台，允许你构建、管理和部署连接到任何模型、利用私有数据并自动化复杂任务的协作代理。注册一个免费账户即可开始使用。
📄 许可证
此 MCP 服务器采用 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目仓库中的 LICENSE 文件。