mcp-server-freesearch

# MCP Server FreeSearch 基于 SearXNG 的免费搜索 MCP 服务器，提供多种类型的网络搜索功能，无需 API 密钥。 ## 功能特性 - **综合搜索** - 通用网页搜索，适用于查找信息、网站、文章等 - **新闻搜索** - 专门搜索新闻内容，获取最新事件和时事信息 - **图片搜索** - 搜索图片和视觉内容 - **视频搜索** - 搜索视频内容，包括教程、电影、直播等 - **地图搜索** - 地理位置查询，查找地点、地标或导航信息 - **音乐搜索** - 搜索音乐、歌曲、专辑或音频资源 - **IT搜索** - 专门搜索信息技术相关内容，适用于编程、系统、网络等技术问题 - **科学搜索** - 搜索科学信息，适用于物理、化学、生物、数学等学术内容 - **文件搜索** - 搜索可下载的公共文件，如 PDF、PPT、DOC 等格式 - **社交媒体搜索** - 搜索社交媒体平台的公开内容 - **速率限制** - 防止 API 滥用 - **全面的错误处理** - 提供详细的错误信息和故障排除建议 - **多种输出格式** - 支持 HTML 和 JSON 格式输出 ## 系统要求 - Python 3.10 或更高版本 - MCP 兼容客户端（如 Claude Desktop、Cursor） - 可访问的 SearXNG 实例 ## 安装步骤 ### 方式一：通过 uvx 安装（推荐） ```bash uvx mcp-server-freesearch ``` ### 方式二：从源码安装 1. 克隆此仓库： ```bash git clone <repository-url> cd mcp-server-freesearch ``` 2. 安装依赖： ```bash uv venv source .venv/bin/activate # Windows 系统: .venv\Scripts\activate uv pip install -e . ``` ## 配置 ### **建议** docker 搭建searx - 构建 ```shell 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输出 ```shell vim ./searxng/config/settings.yml ``` 找到下面的format配置项，添加json ```yaml ... # formats: [html, csv, json, rss] formats: - html - json ``` --- ### 设置所需的环境变量： ```bash 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 系统： ```cmd 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 …