智能网页搜索服务

一个基于SearxNG和Playwright的AI就绪MCP服务器,提供智能网页搜索和自动化功能,支持Docker一键部署。

  • by damameet14
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 damameet14/mcp-webresearch

使用说明

🧠 MCP网络搜索

一 AI就绪的MCP服务器 它使用执行智能网络搜索 SearxNG 和 剧作家 --所有这些都是容器化的,可以一步完成设置。 该项目同时提供 手册 和 码头工人 开发人员和Cline用户的安装选项。


🚀 特性

  • 🔍 集成 SearxNG 元搜索引擎
  • 🧭 通过以下方式实现网络自动化 剧作家
  • 🐳 一个命令Docker设置(同时运行MCP+SearxNG)
  • 🧩 支持JSON搜索结果,便于人工智能处理

新增功能

  • 现在,您可以将截图保存在永久内存中。只需告诉你的AI永久保存屏幕截图。
  • 你可以让AI列出截图。这将为您提供保存屏幕截图的路径。
  • 更多功能即将推出。..

🧰 先决条件

在开始之前,请确保您已经:


⚡ 快速设置(推荐通过Docker)

这是 最简单的方法 让一切运转起来。

  1. 克隆此存储库

    git clone https://github.com/damameet14/mcp-webresearch.git
    cd mcp-webresearch
    
  2. 构建并启动容器

    docker-compose up -d
    

    就是这样! 🎉

    • 这将自动安装所有依赖项。
    • 开始 SearxNG 在端口上 8080.
    • 等到它准备好了。
    • 然后启动您的 MCP服务器.

🔧 临床MCP配置

容器运行后,编辑您的 mcp_settings.json:

"mcpServers": {
  "webresearch": {
    "command": "docker",
    "args": ["exec", "-i", "mcp-webresearch", "node", "/app/index.js"]
  }
}

这将Cline直接连接到您的跑步容器。


🧱 手动设置(无Docker)

如果你不想使用Docker:

# Clone this repo
git clone https://github.com/damameet14/mcp-webresearch.git
cd mcp-webresearch

# Install MCP dependencies
npm install

# Clone and setup SearxNG
git clone https://github.com/searxng/searxng.git
cd searxng
make install

# Enable JSON output (important)
# Add "-json" to line 78 of searx/settings.yml manually

# Start SearxNG
make run # Note that you will have to start the searxng instance everytime you want to use the mcp server.

我正在努力使“no docker”设置也成为一个命令设置。但就目前而言,我建议使用Docker或经历这个累人的过程。

🔧 临床MCP配置(用于手动设置)

容器运行后,编辑您的 mcp_settings.json:

"mcpServers": {
  "webresearch": {
    "command": "node",
    "args": ["<path_to>/mcp-webresearch/index.js"]
  }
}

🧠 运作原理

容器内部:

  1. SearxNG在后台发布。
  2. 一个小的启动脚本(start.sh) 等待SearxNG响应.
  3. 然后是您的MCP服务器(index.js)开始。

这两个进程共享同一网络,并通过以下方式进行通信 localhost:8080.


🧩 项目结构

mcp-webresearch/
├── index.js
├── package.json
├── Dockerfile
├── docker-compose.yml
├── start.sh
└── etc...

⚠️ 备注

  • 默认的SearxNG配置会自动修补以支持 JSON输出 (-json 格式)。
  • 该容器重量轻,不使用时将保持闲置状态。
  • 您可以随时停止它以释放内存。

💡 未来计划

  • 添加与Windows兼容的安装程序
  • 将图像发布到 Docker Hub 和 用于AI代码编辑器的MCP注册表
  • 添加更多工具

兼容性

  • 这适用于Linux和MacOS。
  • 但如果你想在windows上使用它,你可以用wsl(你可以从微软商店下载)

🧑‍💻 作者

认识达玛 (@大马士革14) MCP WebResearch服务器的创建者