MCP Server FreeSearch
基于 SearXNG 的免费搜索 MCP 服务器,提供多种类型的网络搜索功能,无需 API 密钥。
功能特性
- 综合搜索 - 通用网页搜索,适用于查找信息、网站、文章等
- - 专门搜索新闻内容,获取最新事件和时事信息
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
基于 SearXNG 的免费搜索 MCP 服务器,提供多种类型的网络搜索功能,无需 API 密钥。
This server provides tools for web search using a SearXNG instance. It allows you to search web pages, news, images, videos, maps, music, IT information, scientific literature, documents, and social media content.
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 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
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 配置文件中:
~/Library/Application Support/Claude/claude_desktop_config.json%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"
}
}
}
}
用于综合性搜索,最适合查找信息、网站、文章和一般内容。
示例:"法国的首都是什么?" 或 "巧克力曲奇食谱"
专门用于新闻相关查询,最适合时事、最新发展和时效性信息。
示例:"气候变化最新新闻" 或 "最新科技公告"
用于查找图片,最适合视觉内容查询。
示例:"金毛犬图片" 或 "埃菲尔铁塔照片"
用于搜索视频内容,最适合教程、电影、直播或短视频。
示例:"Python 入门视频" 或 "最新 NASA 纪录片"
用于地理位置查询,最适合查找地点、地标或导航相关信息。
示例:"上海外滩在哪里?" 或 "最近的地铁站"
用于查找音乐、歌曲、专辑或音频资源。
示例:"周杰伦青花瓷" 或 "贝多芬月光奏鸣曲"
用于搜索信息技术相关内容,最适合编程、系统、网络和安全等技术问题。
示例:"如何修复蓝屏错误?" 或 "查看内存的 Linux 命令"
用于查找科学信息,适用于物理、化学、生物和数学等学术内容。
示例:"光合作用的过程" 或 "黑洞是如何形成的"
用于查找可下载的公共文件,如 PDF、PPT、DOC 等格式。
示例:"机器学习入门 PDF" 或 "年度财务报告下载"
用于搜索社交媒体平台的公开内容,适合捕获推文、讨论和社交活动。
示例:"关于 AI 的热门推文" 或 "Reddit 远程工作讨论"
所有搜索工具都支持以下参数:
query (string, 必需): 搜索查询字符串language (string, 可选): 搜索语言,默认为 "zh"(中文)safe_search (int, 可选): 安全搜索等级,默认为 1(除图片、视频等为 0)time_range (string, 可选): 时间范围过滤器,默认为空output_format (string, 可选): 输出格式,"html" 或 "json",默认为 "html"所有搜索结果都格式化为文本,每个结果项包含不同的字段:
如果你想发布此包到 PyPI:
安装构建工具:
uv pip install build twine
构建包:
python -m build
上传到 PyPI:
python -m twine upload dist/*
注意:请确保在 pyproject.toml 中更新版本号和仓库 URL。
本项目基于 MIT 许可证开源。
欢迎提交 Issue 和 Pull Request 来改进此项目。
如果遇到问题,请检查:
更多技术支持,请提交 Issue 到项目仓库。
This server provides tools for web search using a SearXNG instance. It allows you to search web pages, news, images, videos, maps, music, IT information, scientific literature, documents, and social
Visão geral
This server provides tools for web search using a SearXNG instance. It allows you to search web pages, news, images, videos, maps, music, IT information, scientific literature, documents, and social media content.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
MCP Server Freesearch roda localmente via stdio.
Última verificação: 2026-10-27. This server provides tools for web search using a SearXNG instance. It allows you to search web pages, news, images, videos, maps, music, IT information, scientific literature, documents, and social media content.