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 許可協議。