与 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 无需改动,纯数据驱动)
135 lines
4.9 KiB
JavaScript
135 lines
4.9 KiB
JavaScript
/**
|
||
* MCP(Model Context Protocol)协议层:工具清单 + JSON-RPC 分发。
|
||
*
|
||
* 与传输无关(stdio / HTTP 都在 server.js 里),只负责把一条 JSON-RPC
|
||
* 消息变成 JSON-RPC 响应。支持的 method:initialize / tools/list / tools/call / ping。
|
||
*
|
||
* 上游参数逐请求从 HTTP header 取(与 mcp/asr、mcp/image_task 同构):
|
||
* X-Web-Search-Base-Url: https://<host>/v1 → 打 {base}/search(配了就用它,不降级)
|
||
* Authorization: Bearer <key> → 可选,裸 key 自动补 Bearer
|
||
* 两者都不配 = 内置免费后端(Parallel → Exa)。stdio 模式没有 header,因此只有免费后端。
|
||
*/
|
||
import { customSearch, freeSearch } from './core.js';
|
||
|
||
export const SERVER_NAME = 'web_search';
|
||
export const VERSION = '1.1.0';
|
||
const DEFAULT_PROTOCOL = '2025-03-26';
|
||
const HDR_AUTH = 'authorization';
|
||
const HDR_BASE = 'x-web-search-base-url';
|
||
|
||
/** 暴露给 MCP 客户端的工具清单。 */
|
||
const TOOLS = [
|
||
{
|
||
name: 'web_search',
|
||
description: 'Search the web. Returns results with title, url, snippet and (when available) publishedAt.',
|
||
inputSchema: {
|
||
type: 'object',
|
||
properties: {
|
||
query: { type: 'string', description: 'Search query text' },
|
||
numResults: { type: 'integer', minimum: 1, default: 8, description: 'Maximum number of results to return (default 8)' },
|
||
},
|
||
required: ['query'],
|
||
},
|
||
},
|
||
];
|
||
|
||
/** 从请求 header 取上游两要素;Authorization 允许写裸 key(自动补 Bearer)。 */
|
||
function upstreamOf(headers) {
|
||
const h = headers || {};
|
||
const raw = String(h[HDR_AUTH] || '').trim();
|
||
return {
|
||
auth: raw ? (/^bearer\s/i.test(raw) ? raw : 'Bearer ' + raw) : '',
|
||
base: String(h[HDR_BASE] || '').trim().replace(/\/+$/, ''),
|
||
};
|
||
}
|
||
|
||
/** 配了地址就必须是完整 http(s):不能是相对路径,也不能把 key 发到别的协议上。 */
|
||
function assertBase(base) {
|
||
let u = null;
|
||
try { u = new URL(base); } catch (_) { u = null; }
|
||
if (!u || (u.protocol !== 'http:' && u.protocol !== 'https:')) {
|
||
throw new Error('X-Web-Search-Base-Url 必须是完整的 http(s) 地址,如 https://<host>/v1');
|
||
}
|
||
}
|
||
|
||
/** 执行一次 tools/call;失败时抛 { code, message } 表示协议级错误。 */
|
||
async function callTool(name, args, headers) {
|
||
if (name !== 'web_search') throw { code: -32602, message: `unknown tool: ${name}` };
|
||
|
||
const params = args ?? {};
|
||
const query = typeof params.query === 'string' && params.query.trim().length > 0
|
||
? params.query.trim()
|
||
: null;
|
||
if (query === null) throw { code: -32602, message: 'query is required' };
|
||
|
||
const numResults = typeof params.numResults === 'number' && Number.isFinite(params.numResults)
|
||
? Math.max(1, Math.floor(params.numResults))
|
||
: 8;
|
||
|
||
const up = upstreamOf(headers);
|
||
let sources;
|
||
try {
|
||
if (up.base) {
|
||
assertBase(up.base);
|
||
sources = await customSearch(query, numResults, up);
|
||
} else {
|
||
sources = await freeSearch(query, numResults, process.env.EXA_API_KEY);
|
||
}
|
||
} catch (error) {
|
||
// 工具级错误回文本、协议层仍成功:模型能读懂并换查询/换工具,
|
||
// 回 JSON-RPC error 只会被 core 拼成「调用失败」,模型反而不好自纠。
|
||
return {
|
||
isError: true,
|
||
content: [{ type: 'text', text: 'Error: ' + String(error && error.message || error) }],
|
||
};
|
||
}
|
||
|
||
return { content: [{ type: 'text', text: JSON.stringify(sources, null, 2) }] };
|
||
}
|
||
|
||
/** 处理一条请求消息,返回 result;失败时抛 { code, message }。 */
|
||
async function handleRequest(message, headers) {
|
||
switch (message.method) {
|
||
case 'initialize':
|
||
return {
|
||
protocolVersion: message.params?.protocolVersion ?? DEFAULT_PROTOCOL,
|
||
capabilities: { tools: {} },
|
||
serverInfo: { name: SERVER_NAME, version: VERSION },
|
||
};
|
||
case 'tools/list':
|
||
return { tools: TOOLS };
|
||
case 'tools/call':
|
||
return callTool(message.params?.name, message.params?.arguments, headers);
|
||
case 'ping':
|
||
return {};
|
||
default:
|
||
throw { code: -32601, message: `method not found: ${String(message.method)}` };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 解析并执行一条 JSON 消息。
|
||
* @param {string} raw JSON-RPC 文本
|
||
* @param {object} [headers] 本次 HTTP 请求的 header(stdio 模式没有,上游参数就走免费后端)
|
||
* @returns 响应信封对象;notification(无 id)返回 null;非法 JSON 返回 undefined。
|
||
*/
|
||
export async function dispatch(raw, headers) {
|
||
let message;
|
||
try {
|
||
message = JSON.parse(raw);
|
||
} catch {
|
||
return undefined;
|
||
}
|
||
if (message.id === undefined) return null; // 通知不响应
|
||
try {
|
||
return { jsonrpc: '2.0', id: message.id, result: await handleRequest(message, headers) };
|
||
} catch (error) {
|
||
const e = error;
|
||
return {
|
||
jsonrpc: '2.0',
|
||
id: message.id,
|
||
error: { code: typeof e.code === 'number' ? e.code : -32603, message: String(e.message ?? error) },
|
||
};
|
||
}
|
||
}
|