git clone https://github.com/ZhenMoon/mcp-search-server.git
cd mcp-search-server
npm install
npm run build

# 构建镜像
docker compose build

# 启动（前台运行，MCP stdio 模式）
docker compose run --rm mcp-search

# 或在后台运行
docker compose up -d

{
  "mcpServers": {
    "mcp-search": {
      "command": "docker",
      "args": ["compose", "run", "--rm", "mcp-search"]
    }
  }
}

# 创建配置目录
mkdir config
cp mcp-search-config.example.jsonc config/mcp-search-config.json

# 编辑 config/mcp-search-config.json 后启动
docker compose run --rm mcp-search

{
  "mcpServers": {
    "mcp-search": {
      "command": "node",
      "args": ["<path>/mcp-search-server/build/index.js"]
    }
  }
}

SEARCH_DISABLED_ENGINES=duckduckgo,brave,sogou node build/index.js

{
  "customEngines": [
    {
      "name": "mysearch",
      "displayName": "MySearch",
      "searchUrl": "https://example.com/search?q={query}&page={page}",
      "selectors": {
        "item": ".result-item",
        "title": "h2 a",
        "url": "h2 a@href",
        "description": ".desc"
      },
      "headers": { "Referer": "https://example.com/" },
      "pageParam": "page",
      "startPage": 1
    }
  ]
}

{
  "rateLimits": {
    "baidu.com": { "minDelay": 1000, "maxDelay": 3000 },
    "so.com": { "minDelay": 800, "maxDelay": 2000 }
  }
}

{
  "extraHeaders": {
    "baidu.com": {
      "Referer": "https://www.baidu.com/",
      "Connection": "keep-alive"
    }
  }
}

mcp-search-server/
├── src/
│   ├── index.ts              # MCP 服务器入口（9 个工具）
│   ├── types.ts              # 类型定义
│   ├── aggregator.ts         # 多引擎聚合 + 去重 + 排序 + 元数据
│   ├── config.ts             # 配置文件加载（JSON/JSONC）
│   ├── customEngine.ts       # 配置驱动的通用搜索引擎
│   ├── metadata.ts           # 时间/域名提取、JSON 格式化
│   ├── browser.ts            # 无头浏览器管理 + 隐身增强
│   ├── cache.ts              # 磁盘缓存 (TTL 5min)
│   ├── circuitBreaker.ts     # 引擎熔断保护
│   ├── dedupContent.ts       # 网页正文去重
│   ├── filter.ts             # 无用信息过滤
│   ├── queryExpander.ts      # 同义词查询扩展
│   ├── queryAdapter.ts       # 引擎查询语法适配
│   ├── fetcher.ts            # 网页抓取 (Readability + 轮换 UA)
│   ├── scraper.ts            # 反爬共享工具（指纹轮换、代理、频率限制）
│   ├── searchContext.ts      # 搜索结果会话管理 + 搜索场景
│   ├── session.ts            # Cookie 会话管理 + 磁盘持久化
│   └── engines/
│       ├── bing.ts           # 必应
│       ├── baidu.ts          # 百度
│       ├── 360.ts            # 360 搜索
│       ├── sogou.ts          # 搜狗
│       ├── duckduckgo.ts     # DuckDuckGo
│       ├── brave.ts          # Brave Search
│       ├── github.ts         # GitHub
│       └── zhihu.ts          # 知乎（浏览器直连 / Bing site: 回退）
├── mcp-search-config.example.json   # 配置示例（纯净 JSON）
├── mcp-search-config.example.jsonc  # 配置示例（JSONC，含注释）
├── package.json
├── tsconfig.json
├── README.md                 # 中文文档
└── README.en.md              # English

搜索 + 抓取组合使用：
  search("Rust 语言 入门教程", maxResults: 5)
  fetch("https://rustwiki.org/zh-CN/book/")

指定引擎（含自定义）：
  search(engines: ["bing", "mysearch"], query: "Vue.js 教程")

深度研究：
  research("Rust vs Go 性能对比", maxResults: 8, fetchCount: 3)

结果分析：
  analyze("量子计算最新进展", mode: "正反面", engines: ["bing", "zhihu"])

环境变量自定义：
  SEARCH_ENGINES=bing,github node build/index.js

配置文件 (mcp-search-config.json)：
  export SEARCH_CONFIG_PATH=/etc/mcp-search-config.json