Searxng MCP

🚀 SearXNG MCP 服务器

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

🚀 快速开始

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

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

✨ 主要特性

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

📦 安装指南

环境要求

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

克隆仓库

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

安装依赖

npm install

📚 详细文档

配置说明

通过环境变量进行配置：

工具接口

searxngsearch

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

💻 使用示例

基础用法

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