{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xyzhf2h2xwrh","handle":"mcp-server-freesearch","url":"https://wellknown.network/agents/mcp-server-freesearch","links":{"self":"https://wellknown.network/agents/mcp-server-freesearch/record.json","html":"https://wellknown.network/agents/mcp-server-freesearch","markdown":"https://wellknown.network/agents/mcp-server-freesearch/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-freesearch","status":"https://wellknown.network/api/v1/agents/mcp-server-freesearch/status","claim":"https://wellknown.network/agents/mcp-server-freesearch/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-freesearch/claim.json","badge":"https://wellknown.network/agents/mcp-server-freesearch/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-freesearch/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-freesearch/tools"},"ard":{"identifier":"urn:air::server:mcp-server-freesearch","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-freesearch","summary":"基于 SearXNG 的免费搜索 MCP 服务器","description":"# MCP Server FreeSearch\n\n基于 SearXNG 的免费搜索 MCP 服务器，提供多种类型的网络搜索功能，无需 API 密钥。\n\n## 功能特性\n\n- **综合搜索** - 通用网页搜索，适用于查找信息、网站、文章等\n- **新闻搜索** - 专门搜索新闻内容，获取最新事件和时事信息\n- **图片搜索** - 搜索图片和视觉内容\n- **视频搜索** - 搜索视频内容，包括教程、电影、直播等\n- **地图搜索** - 地理位置查询，查找地点、地标或导航信息\n- **音乐搜索** - 搜索音乐、歌曲、专辑或音频资源\n- **IT搜索** - 专门搜索信息技术相关内容，适用于编程、系统、网络等技术问题\n- **科学搜索** - 搜索科学信息，适用于物理、化学、生物、数学等学术内容\n- **文件搜索** - 搜索可下载的公共文件，如 PDF、PPT、DOC 等格式\n- **社交媒体搜索** - 搜索社交媒体平台的公开内容\n- **速率限制** - 防止 API 滥用\n- **全面的错误处理** - 提供详细的错误信息和故障排除建议\n- **多种输出格式** - 支持 HTML 和 JSON 格式输出\n\n## 系统要求\n\n- Python 3.10 或更高版本\n- MCP 兼容客户端（如 Claude Desktop、Cursor）\n- 可访问的 SearXNG 实例\n\n## 安装步骤\n\n### 方式一：通过 uvx 安装（推荐）\n\n```bash\nuvx mcp-server-freesearch\n```\n\n### 方式二：从源码安装\n\n1. 克隆此仓库：\n   ```bash\n   git clone <repository-url>\n   cd mcp-server-freesearch\n   ```\n\n2. 安装依赖：\n   ```bash\n   uv venv\n   source .venv/bin/activate  # Windows 系统: .venv\\Scripts\\activate\n   uv pip install -e .\n   ```\n\n## 配置\n\n### **建议** docker 搭建searx\n\n- 构建\n```shell\ndocker pull docker.io/searxng/searxng:latest\n# Create directories for configuration and persistent data\n$ mkdir -p ./searxng/config/ ./searxng/data/\n$ cd ./searxng/\n\n# Run the container\n$ docker run --name searxng --replace -d \\\n    -p 8888:8080 \\\n    -v \"./config/:/etc/searxng/\" \\\n    -v \"./data/:/var/cache/searxng/\" \\\n    docker.io/searxng/searxng:latest\n```\n- 配置支持json输出\n```shell\nvim ./searxng/config/settings.yml\n```\n\n找到下面的format配置项，添加json\n```yaml\n  ...\n  # formats: [html, csv, json, rss]\n  formats:\n    - html\n    - json\n```\n---\n\n### 设置所需的环境变量：\n\n```bash\nexport SEARXNG_API_URL=\"https://searx.bndkt.io\"  # SearXNG 实例 URL\nexport SEARXNG_COOKIE=\"\"  # 可选：SearXNG Cookie\nexport SEARXNG_USER_AGENT=\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\"  # 可选：用户代理\nexport SEARXNG_REQUEST_TIMEOUT=\"10\"  # 可选：请求超时时间（秒）\nexport ENV_FASTMCP_LOG_LEVEL=\"WARNING\"  # 可选：日志级别\n```\n\nWindows 系统：\n```cmd\nset SEARXNG_API_URL=https://searx.bndkt.io\nset SEARXNG_COOKIE=\nset SEARXNG_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\n…","publisher":null,"homepage":"https://github.com/wzj177/mcp-server-freesearch","repository":"https://github.com/wzj177/mcp-server-freesearch","version":"0.1.2","license":null,"protocols":["mcp"],"tags":["mcp","search","searxng","web-search","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-freesearch","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-freesearch","registry":"pypi","observedAt":"2026-10-28T13:24:50.480Z","publishedAt":"2025-08-07T13:54:52.186252Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-freesearch","url":"https://pypi.org/project/mcp-server-freesearch/","firstSeenAt":"2026-09-10T03:20:32.556Z","fetchedAt":"2026-10-28T13:23:39.029Z","normalizedAt":"2026-10-28T13:23:39.029Z"}]},"firstSeenAt":"2026-09-10T03:20:32.556Z","updatedAt":"2026-10-28T13:24:50.480Z"}