与 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 无需改动,纯数据驱动)
166 lines
7.2 KiB
JavaScript
166 lines
7.2 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* MCP server 入口 —— 网页搜索(自定义 /search 上游,或内置免费 Parallel / Exa)。
|
||
*
|
||
* 本地重构版(上游:@sheep233_/dsh-web-search-free),零运行时依赖,直接 node 启动。
|
||
*
|
||
* ## 双传输
|
||
* - **stdio**(默认):`node server.js`
|
||
* - `claude mcp add web_search -- node <路径>/server.js`
|
||
* - 没有 HTTP header,因此只能用内置免费后端
|
||
* - **HTTP/SSE**(监听端口):`node server.js --http --port 3000 --host 0.0.0.0`
|
||
* - 兼容 Streamable HTTP(`POST /`)与老式 SSE(`GET /sse` + `POST /messages`)
|
||
* - `GET /` 或 `GET /health` 返回服务信息,可做健康检查
|
||
*
|
||
* 上游参数逐请求从 HTTP header 取(与 mcp/asr、mcp/image_task 同构,容器不存密钥):
|
||
* X-Web-Search-Base-Url: https://<host>/v1 → 打 {base}/search
|
||
* Authorization: Bearer <key> → 可选,裸 key 自动补 Bearer
|
||
* 两者都不配 = 免费后端。
|
||
*
|
||
* 环境变量:EXA_API_KEY(可选,提升 Exa 匿名限额);SEARCH_TIMEOUT_MS(可选,上游超时)。
|
||
*/
|
||
import { createInterface } from 'node:readline';
|
||
import { createServer } from 'node:http';
|
||
import { randomUUID } from 'node:crypto';
|
||
import { SERVER_NAME, VERSION, dispatch } from './mcp.js';
|
||
|
||
// ── 优雅退出 ────────────────────────────────────────────────────────────────
|
||
// 容器里 node 以 PID 1 运行且未注册 SIGTERM 处理器时,内核不会对其执行默认
|
||
// 终止动作,docker stop/restart 会白等满 10s 宽限期才被 SIGKILL。
|
||
// 显式注册处理器立即关服务;3s 兜底定时器防止长连接卡住 close 回调。
|
||
let httpServer = null;
|
||
let forceCloseConnections = () => {};
|
||
let shuttingDown = false;
|
||
|
||
function shutdown(sig) {
|
||
if (shuttingDown) return;
|
||
shuttingDown = true;
|
||
process.stdout.write(`[web_search] 收到 ${sig},停止服务\n`);
|
||
forceCloseConnections();
|
||
if (httpServer === null) process.exit(0); // stdio 模式无监听,直接退
|
||
httpServer.close(() => process.exit(0));
|
||
setTimeout(() => process.exit(0), 3000).unref();
|
||
}
|
||
process.on('SIGTERM', () => shutdown('SIGTERM'));
|
||
process.on('SIGINT', () => shutdown('SIGINT'));
|
||
|
||
// ── stdio 传输(默认)───────────────────────────────────────────────────────
|
||
function runStdio() {
|
||
const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
|
||
rl.on('line', (line) => {
|
||
const trimmed = line.trim();
|
||
if (trimmed.length === 0) return;
|
||
void dispatch(trimmed).then((response) => {
|
||
if (response != null) {
|
||
process.stdout.write(`${JSON.stringify(response)}\n`);
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// ── HTTP/SSE 传输(--http [--port <n>] [--host <addr>])──────────────────────
|
||
function runHttp(host, port) {
|
||
/** sessionId → 老式 SSE 响应流(GET /sse 建立的连接)。 */
|
||
const sseChannels = new Map();
|
||
|
||
const server = createServer((req, res) => {
|
||
const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
|
||
|
||
// 健康检查 / 服务信息
|
||
if (req.method === 'GET' && (url.pathname === '/' || url.pathname === '/health')) {
|
||
res.writeHead(200, { 'content-type': 'application/json' });
|
||
res.end(JSON.stringify({ name: SERVER_NAME, version: VERSION, transport: 'http/sse', port }));
|
||
return;
|
||
}
|
||
|
||
// 老式 SSE 通道:GET /sse(MCP-Session-Id 关联后续 POST /messages)
|
||
if (req.method === 'GET' && url.pathname === '/sse') {
|
||
const sessionId = req.headers['mcp-session-id'] ?? randomUUID();
|
||
res.writeHead(200, {
|
||
'content-type': 'text/event-stream',
|
||
'cache-control': 'no-cache',
|
||
'connection': 'keep-alive',
|
||
'mcp-session-id': sessionId,
|
||
});
|
||
res.write(`event: endpoint\ndata: /messages?session_id=${sessionId}\n\n`);
|
||
sseChannels.set(sessionId, res);
|
||
req.on('close', () => { sseChannels.delete(sessionId); });
|
||
return;
|
||
}
|
||
|
||
// 消息端点:POST /(Streamable HTTP)与 POST /messages(老式 SSE)
|
||
if (req.method === 'POST' && (url.pathname === '/' || url.pathname === '/messages')) {
|
||
const sessionId = req.headers['mcp-session-id'] ?? url.searchParams.get('session_id') ?? undefined;
|
||
let body = '';
|
||
req.on('data', (chunk) => { body += chunk.toString(); });
|
||
req.on('end', () => {
|
||
// header 必须随消息带进协议层:上游地址 / 鉴权都是逐请求带入的(容器不存密钥)
|
||
void dispatch(body, req.headers).then((response) => {
|
||
if (response === null) { // 通知
|
||
res.writeHead(202).end();
|
||
return;
|
||
}
|
||
const payload = JSON.stringify(response);
|
||
// 老式 SSE:结果推回通道连接
|
||
if (url.pathname === '/messages' && sessionId !== undefined && sseChannels.has(sessionId)) {
|
||
sseChannels.get(sessionId).write(`data: ${payload}\n\n`);
|
||
res.writeHead(202, { 'mcp-session-id': sessionId }).end();
|
||
return;
|
||
}
|
||
// Streamable HTTP:按 Accept 返回 SSE 帧或裸 JSON
|
||
if (String(req.headers.accept ?? '').includes('text/event-stream')) {
|
||
res.writeHead(200, {
|
||
'content-type': 'text/event-stream',
|
||
'cache-control': 'no-cache',
|
||
...(sessionId !== undefined ? { 'mcp-session-id': sessionId } : {}),
|
||
});
|
||
res.end(`data: ${payload}\n\n`);
|
||
return;
|
||
}
|
||
res.writeHead(200, {
|
||
'content-type': 'application/json',
|
||
...(sessionId !== undefined ? { 'mcp-session-id': sessionId } : {}),
|
||
});
|
||
res.end(payload);
|
||
});
|
||
});
|
||
return;
|
||
}
|
||
|
||
res.writeHead(404, { 'content-type': 'application/json' });
|
||
res.end(JSON.stringify({
|
||
error: 'not found',
|
||
hint: 'MCP endpoints: POST / (streamable http), GET /sse + POST /messages (legacy sse), GET / (info)',
|
||
}));
|
||
});
|
||
|
||
httpServer = server;
|
||
forceCloseConnections = () => {
|
||
// 掐掉老式 SSE 长连接与 keep-alive 连接,否则 server.close() 回调不会触发
|
||
for (const res of sseChannels.values()) res.destroy();
|
||
sseChannels.clear();
|
||
server.closeAllConnections?.();
|
||
};
|
||
|
||
server.listen(port, host, () => {
|
||
process.stdout.write(`[web_search] HTTP/SSE listening on http://${host}:${port} (MCP: POST /, GET /sse + POST /messages)\n`);
|
||
});
|
||
}
|
||
|
||
// ── 入口:参数解析 ──────────────────────────────────────────────────────────
|
||
const args = process.argv.slice(2);
|
||
const httpMode = args.includes('--http')
|
||
|| (args.includes('--transport') && args[args.indexOf('--transport') + 1] === 'http');
|
||
|
||
const readFlag = (name, fallback) => {
|
||
const index = args.indexOf(name);
|
||
return index >= 0 && args[index + 1] !== undefined ? args[index + 1] : fallback;
|
||
};
|
||
|
||
if (httpMode) {
|
||
const port = Number(readFlag('--port', 3100));
|
||
runHttp(readFlag('--host', '127.0.0.1'), Number.isFinite(port) ? port : 3100);
|
||
} else {
|
||
runStdio();
|
||
}
|