web_search 支持自建 /search 上游:上游参数逐请求由 header 带入
与 image_task / asr 同构:容器不存密钥,配置只写在 config.yml 的 mcp_servers[].headers。 - 新增 X-Web-Search-Base-Url(拼 /search)与可选 Authorization(裸 key 自动补 Bearer); 配了地址就以它为准,失败直接报错,不静默退回免费后端 - 没配地址时行为不变:Parallel 优先,失败自动退 Exa(降级从前端 provider 参数收回服务端) - 工具 schema 去掉 provider 参数(模型不该决定走哪家上游),只留 query / numResults - 响应统一归一化:丢弃无 url 条目,snippet 压平并截断 500 字,published_at 映射为 publishedAt - server.js 把 req.headers 传进协议层;stdio 模式无 header,只能用免费后端 - 设置页预设补两条可选字段(settings.js 无需改动,纯数据驱动)
This commit is contained in:
@@ -1,15 +1,41 @@
|
||||
# web_search
|
||||
|
||||
免费网页搜索 MCP server 的本地重构版(上游开源实现:[@sheep233_/dsh-web-search-free](https://github.com/sheep-programmer/dsh-web-search-free),MIT)。
|
||||
网页搜索 MCP server 的本地重构版(上游开源实现:[@sheep233_/dsh-web-search-free](https://github.com/sheep-programmer/dsh-web-search-free),MIT)。
|
||||
|
||||
零运行时依赖,只用 Node 内置 `fetch`(Node ≥ 18),**无需 npm install,直接 `node server.js` 启动**。
|
||||
|
||||
## 三路上游
|
||||
|
||||
| 条件 | 走哪 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| 请求带了 `X-Web-Search-Base-Url` | 你的 `POST {base}/search` | key 可选(`Authorization`)。**失败直接报错,不静默退回免费后端** |
|
||||
| 没带 | Parallel(免费匿名) | 失败自动退 Exa |
|
||||
| stdio 模式 | 只能免费 | stdio 没有 HTTP header |
|
||||
|
||||
自定义上游的协议:
|
||||
|
||||
```http
|
||||
POST {base}/search
|
||||
Authorization: Bearer <key>
|
||||
Content-Type: application/json
|
||||
|
||||
{"query":"2027山东省考公告","max_results":5}
|
||||
```
|
||||
|
||||
```json
|
||||
{"query":"...","type":"text2text","results":[{"title":"...","url":"https://...","snippet":"..."}]}
|
||||
```
|
||||
|
||||
响应归一化成 `[{url, title?, snippet?, publishedAt?}]`:`results[]` 里没有 `url` 的条目丢弃,
|
||||
`snippet` 压平空白并截断到 500 字(搜索结果会进对话历史、之后每轮都可能被整条重放,不截等于白烧 token),
|
||||
`published_at` / `publishedAt` / `publish_date` 任一存在则映射为 `publishedAt`。
|
||||
|
||||
## 结构
|
||||
|
||||
| 文件 | 职责 |
|
||||
| --- | --- |
|
||||
| `core.js` | 搜索后端:Parallel(默认)/ Exa(备用)免费 MCP 端点封装 + 响应解析 |
|
||||
| `mcp.js` | MCP 协议层:`web_search` 工具定义 + JSON-RPC 分发 |
|
||||
| `core.js` | 搜索后端:自定义 `/search` + Parallel / Exa 免费 MCP 端点封装 + 响应解析 |
|
||||
| `mcp.js` | MCP 协议层:`web_search` 工具定义 + JSON-RPC 分发 + 从 header 取上游参数 |
|
||||
| `server.js` | 入口:CLI 参数 + stdio / HTTP/SSE 双传输 |
|
||||
|
||||
## 本地启动
|
||||
@@ -33,6 +59,10 @@ MCP 端点:
|
||||
- `EXA_API_KEY` — 提升 Exa 匿名限额
|
||||
- `SEARCH_TIMEOUT_MS` — 上游搜索超时,默认 30000
|
||||
|
||||
上游地址 / 鉴权**不是**环境变量:由调用方随每个请求用 header 带入(见上面「三路上游」),
|
||||
agent 侧写在 `config.yml` 的 `mcp_servers[name=web_search].headers`。换接口只改 YAML + 重启 core,
|
||||
不碰 `.env`、不重建镜像;容器自身不存任何平台密钥。
|
||||
|
||||
## Docker
|
||||
|
||||
`docker-compose.yml` 中的 `mcp_web_search` 服务直接构建本目录,Dockerfile 已改为拷贝源码启动(不再有 `npm install -g`)。
|
||||
@@ -47,4 +77,4 @@ docker exec mcp_web_search node -e "fetch('http://localhost:3000/health').then(r
|
||||
# {"name":"web_search","version":"...","transport":"http/sse","port":3000}
|
||||
```
|
||||
|
||||
该服务**无服务端鉴权**(上游是免费端点),**永远不要**对外映射端口——会被白嫆搜索额度。
|
||||
该服务**无服务端鉴权**,**永远不要**对外映射端口——会被白嫖搜索额度(自定义上游时还会把你的 key 白送出去)。
|
||||
|
||||
Reference in New Issue
Block a user