MCP Searxng

🚀 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 实例。

1. 从 公共实例列表 中选择一个 SearxNG 实例，或者自行部署。
2. 将 SEARXNG_URL 环境变量设置为该实例的 URL。
3. 如果未设置，服务器默认使用 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 文件。