MCP 服务器

mcp-server-freesearch

A free search MCP server powered by SearXNG, offering various search types without requiring an API key.

README

MCP Server FreeSearch

基于 SearXNG 的免费搜索 MCP 服务器，提供多种类型的网络搜索功能，无需 API 密钥。

功能特性

综合搜索 - 通用网页搜索，适用于查找信息、网站、文章等
新闻搜索 - 专门搜索新闻内容，获取最新事件和时事信息
图片搜索 - 搜索图片和视觉内容
视频搜索 - 搜索视频内容，包括教程、电影、直播等
地图搜索 - 地理位置查询，查找地点、地标或导航信息
音乐搜索 - 搜索音乐、歌曲、专辑或音频资源
IT搜索 - 专门搜索信息技术相关内容，适用于编程、系统、网络等技术问题
科学搜索 - 搜索科学信息，适用于物理、化学、生物、数学等学术内容
文件搜索 - 搜索可下载的公共文件，如 PDF、PPT、DOC 等格式
社交媒体搜索 - 搜索社交媒体平台的公开内容
速率限制 - 防止 API 滥用
全面的错误处理 - 提供详细的错误信息和故障排除建议
多种输出格式 - 支持 HTML 和 JSON 格式输出

系统要求

Python 3.10 或更高版本
MCP 兼容客户端（如 Claude Desktop、Cursor）
可访问的 SearXNG 实例

安装步骤

方式一：通过 uvx 安装（推荐）

uvx mcp-server-freesearch

方式二：从源码安装

克隆此仓库：

git clone <repository-url>
cd mcp-server-freesearch

安装依赖：

uv venv
source .venv/bin/activate  # Windows 系统: .venv\Scripts\activate
uv pip install -e .

配置

建议 docker 搭建searx

构建

docker pull docker.io/searxng/searxng:latest
# Create directories for configuration and persistent data
$ mkdir -p ./searxng/config/ ./searxng/data/
$ cd ./searxng/

# Run the container
$ docker run --name searxng --replace -d \
    -p 8888:8080 \
    -v "./config/:/etc/searxng/" \
    -v "./data/:/var/cache/searxng/" \
    docker.io/searxng/searxng:latest

配置支持json输出

vim ./searxng/config/settings.yml

找到下面的format配置项，添加json

  ...
  # formats: [html, csv, json, rss]
  formats:
    - html
    - json

设置所需的环境变量：

export SEARXNG_API_URL="https://searx.bndkt.io"  # SearXNG 实例 URL
export SEARXNG_COOKIE=""  # 可选：SearXNG Cookie
export SEARXNG_USER_AGENT="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"  # 可选：用户代理
export SEARXNG_REQUEST_TIMEOUT="10"  # 可选：请求超时时间（秒）
export ENV_FASTMCP_LOG_LEVEL="WARNING"  # 可选：日志级别

Windows 系统：

set SEARXNG_API_URL=https://searx.bndkt.io
set SEARXNG_COOKIE=
set SEARXNG_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
set SEARXNG_REQUEST_TIMEOUT=10
set ENV_FASTMCP_LOG_LEVEL=WARNING

使用方法

运行服务器

通过 uvx 运行（推荐）：

uvx mcp-server-freesearch

或者从源码直接运行：

python main.py

开发和测试

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector python main.py

配置 Claude Desktop

将以下配置添加到 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "free-search": {
      "command": "uvx",
      "args": [
        "mcp-server-freesearch"
      ],
      "env": {
        "SEARXNG_API_URL": "https://searx.bndkt.io"
      }
    }
  }
}

如果你是从源码运行，则使用：

{
  "mcpServers": {
    "free-search": {
      "command": "python",
      "args": [
        "/path/to/your/mcp-server-freesearch/main.py"
      ],
      "env": {
        "SEARXNG_API_URL": "https://searx.bndkt.io"
      }
    }
  }
}