MCP Server FreeSearch
基于 SearXNG 的免费搜索 MCP 服务器,提供多种类型的网络搜索功能,无需 API 密钥。
功能特性
- 综合搜索 - 通用网页搜索,适用于查找信息、网站、文章等
- - 专门搜索新闻内容,获取最新事件和时事信息
Power your agent
Instal dari penerbit. Bukan endpoint PlugMCP.
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di 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.
BukaDari penerbit
基于 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
Ringkasan umum
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.
Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
MCP Server Freesearch berjalan secara lokal melalui stdio.
Terakhir diperiksa 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.