JinDaGe - searxng-mcp MCP Details

article

README

🚀 SearXNG MCP 服务器

一个实现模型上下文协议（MCP）的服务器，让您能借助 SearXNG 开展网络搜索。SearXNG 是一款尊重隐私的元搜索引擎，此服务器为您提供便捷、安全且个性化的搜索体验。

🚀 快速开始

SearXNG MCP 服务器可让您通过 SearXNG 进行网络搜索。以下是快速搭建并使用该服务器的步骤：

确保您的环境满足要求，即 Node.js 14 或更高版本，以及 npm 6 或更高版本。
克隆仓库到本地并安装依赖。
根据需求配置环境变量。
启动服务器并进行测试。

✨ 主要特性

支持多语言：可依据指定的语言代码开展搜索。
时间范围过滤：能选择最近一天、一周、一个月或一年内的搜索结果。
类别筛选：可在预设的分类（如通用、新闻等）中进行搜索。
引擎自定义：能指定使用特定的搜索引擎。
安全搜索：提供不同级别的安全搜索选项，涵盖关闭、温和和严格模式。
分页支持：可按需选择不同的结果页面。
结果数量控制：能限制返回的最大搜索结果数。

📦 安装指南

环境要求

Node.js 14 或更高版本
npm 6 或更高版本

克隆仓库

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

安装依赖

npm install

📚 详细文档

配置说明

通过环境变量进行配置： | 属性 | 详情 | |------|------| | SEARXNG_INSTANCE | SearXNG 实例 URL，默认值为 http://127.0.0.1:80 | | PORT | MCP 服务监听端口，默认值为 3000 |

工具接口

searxngsearch

使用 SearXNG 进行网络搜索。支持自定义多个搜索参数。

| 参数名称 | 类型 | 详情 | 默认值 | 是否必填 | |------|------|------|------|------| | query | string | 搜索关键词 | - | 是 | | language | string | 搜索结果语言代码（如 'zh', 'en', 'fr'） | 'zh' | 否 | | time_range | string | 时间范围过滤。可选值：'day', 'week', 'month', 'year' | null | 否 | | categories | array | 搜索分类，如 ['通用', '新闻'] | null | 否 | | engines | array | 特定搜索引擎列表 | null | 否 | | safesearch | number | 安全搜索级别。0（关闭）、1（温和）、2（严格） | 1 | 否 | | pageno | number | 结果页面号，从1开始 | 1 | 否 | | max_results | number | 最大返回结果数，范围1 - 50 | 10 | 否 |

💻 使用示例

基础用法

通过 MCP Inspector 测试：

npm run inspector

打开浏览器访问 http://localhost:3000，然后在 Inspector 界面选择 SearXNG Search 工具进行测试。

高级用法

// 示例请求
const result = await client.callTool('searxngsearch', {
  query: '人工智能',
  language: 'zh',
  time_range: 'week',
  categories: ['通用', '新闻'],
  safesearch: 1,
  max_results: 5
});

🔧 技术细节

开发指南

快速开始

# 克隆仓库
git clone https://github.com/tisDDM/searxng-mcp.git
cd searxng-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式（实时更新）
npm run watch

测试工具

使用 MCP Inspector 进行功能测试：

npm run inspector

📄 许可证

本项目采用 MIT License 许可协议。

searxng-mcp