Searxng Simple MCP

Searxng Simple MCP

一個基於SearxNG的MCP服務器，為AI助手提供隱私保護的網頁搜索功能

搜索工具人工智能聊天機器人 #隱私搜索 #AI集成 #MCP協議 #元搜索 .Python

rating : 2.5 points

downloads : 15

update time : 2025-04-29

Installation

Copy the following command to your Client for configuration

{
  "mcpServers": {
    "searxng": {
      "command": "pipx",
      "args": [
        "run", "searxng-simple-mcp@latest"
      ],
      "env": {
        "SEARXNG_MCP_SEARXNG_URL": "https://your-instance.example.com"
      }
    }
  }
}

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": [
        "run", "searxng-simple-mcp@latest"
      ],
      "env": {
        "SEARXNG_MCP_SEARXNG_URL": "https://your-instance.example.com"
      }
    }
  }
}

{
  "mcpServers": {
    "searxng": {
      "command": "python",
      "args": ["-m", "searxng_simple_mcp.server"],
      "env": {
        "SEARXNG_MCP_SEARXNG_URL": "https://your-instance.example.com"
      }
    }
  }
}

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-e", "SEARXNG_MCP_SEARXNG_URL=http://localhost:8080",
        "ghcr.io/sacode/searxng-simple-mcp:latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "searxng": {
      "url": "http://localhost:8000",
      "transport": "sse"
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 與Searx搜索引擎集成的簡單MCP服務器

這是一個用於與Searx搜索引擎集成的簡單MCP（機器控制協議）服務器。該服務器允許通過MCP協議連接到Searx，並支持多種配置選項以滿足不同的需求。

🚀 快速開始

本項目是一個簡單的MCP服務器，可與Searx搜索引擎集成。以下將詳細介紹其安裝、配置、使用、開發、發佈等方面的內容。

📦 安裝指南

使用pip安裝

pip install searxng-simple-mcp

使用Docker安裝

docker pull yourusername/searxng-simple-mcp:latest

🛠️ 配置說明

通過設置以下環境變量來配置服務器的行為：

屬性	詳情
`SEARXNG_MCP_SEARXNG_URL`	Searx搜索引擎的URL（默認值為`https://searx.info`）
`SEARXNG_MCP_TIMEOUT`	與Searx通信的超時時間（以秒為單位，建議值為30）
`SEARXNG_MCP_MAX_RESULTS`	每次查詢的最大結果數（建議值為20）
`SEARXNG_MCP_LANGUAGE`	搜索語言（默認值為`all`）
`SEARXNG_MCP_ENABLE_TAG_FILTERS`	啟用或禁用標籤過濾功能（值為`true`或`false`，默認值為`true`）
`SEARXNG_MCP_TAG_BLACKLIST`	要排除的標籤列表，以逗號分隔
`SEARXNG_MCP_TAG_WHITELIST`	允許使用的標籤列表，以逗號分隔

💻 使用示例

基礎用法

使用pip安裝的方式運行

searxng-simple-mcp run --searx-url https://example.com --timeout 30 --max-results 20 --language all --enable-tag-filters true --tag-blacklist adult,spam --tag-whitelist news,tech

使用Docker安裝的方式運行

docker run -e SEARXNG_MCP_SEARXNG_URL=https://example.com -e SEARXNG_MCP_TIMEOUT=30 -e SEARXNG_MCP_MAX_RESULTS=20 -e SEARXNG_MCP_LANGUAGE=all -e SEARXNG_MCP_ENABLE_TAG_FILTERS=true -e SEARXNG_MCP_TAG_BLACKLIST=adult,spam -e SEARXNG_MCP_TAG_WHITELIST=news,tech yourusername/searxng-simple-mcp:latest

🔨 開發指南

安裝依賴項

uv pip install -e .

運行服務器

python -m src.searxng_simple_mcp.server

🚀 發佈到PyPI

安裝開發依賴項

npm run install:deps

構建和檢查包

npm run build:package
npm run check:package

發佈到PyPI

npm run publish:pypi

🐳 Docker配置

注意事項

⚠️ 重要提示

使用--network=host選項以訪問主機上的服務。

使用-p 8000:8000選項以將SSE服務器暴露到網絡。

📁 項目結構

searxng-simple-mcp/
├── src/
│   ├── run_server.py         # 入口腳本
│   └── searxng_simple_mcp/   # 包含主要實現的模塊
├── README.md                 # 項目文檔
└── setup.py                  # 安裝腳本

👥 貢獻說明

歡迎任何人提交問題、拉取請求或提出建議。請在GitHub倉庫中查看具體的貢獻指南。

此文檔詳細介紹瞭如何安裝、配置和使用Searx MCP服務器，並提供了開發和發佈的相關信息。如需進一步幫助，請參考項目倉庫中的更多資源。

Featured MCP Services

百度地圖MCP Server是國內首個兼容MCP協議的地圖服務，提供地理編碼、路線規劃等10個標準化API接口，支持Python和Typescript快速接入，賦能智能體實現地圖相關功能。

Markdownify MCP

Markdownify是一個多功能文件轉換服務，支持將PDF、圖片、音頻等多種格式及網頁內容轉換為Markdown格式。

Firecrawl MCP Server

Firecrawl MCP Server是一個集成Firecrawl網頁抓取能力的模型上下文協議服務器，提供豐富的網頁抓取、搜索和內容提取功能。

Sequential Thinking MCP Server

一個基於MCP協議的結構化思維服務器，通過定義思考階段幫助分解複雜問題並生成總結

Magic Component Platform (MCP) 是一個AI驅動的UI組件生成工具，通過自然語言描述幫助開發者快速創建現代化UI組件，支持多種IDE集成。

Edgeone Pages MCP Server

EdgeOne Pages MCP是一個通過MCP協議快速部署HTML內容到EdgeOne Pages並獲取公開URL的服務

一個基於Python的MCP服務器，通過Notion API提供高級待辦事項管理和內容組織功能，實現AI模型與Notion的無縫集成。

Context7 MCP是一個為AI編程助手提供即時、版本特定文檔和代碼示例的服務，通過Model Context Protocol直接集成到提示中，解決LLM使用過時信息的問題。

AIbase

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご

© 2025AIbase