🚀 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 许可协议。