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:
+55
-16
@@ -2,25 +2,30 @@
|
||||
* MCP(Model Context Protocol)协议层:工具清单 + JSON-RPC 分发。
|
||||
*
|
||||
* 与传输无关(stdio / HTTP 都在 server.js 里),只负责把一条 JSON-RPC
|
||||
* 消息变成 JSON-RPC 响应。支持的 method 与上游 dsh-web-search-free 一致:
|
||||
* initialize / tools/list / tools/call / ping。
|
||||
* 消息变成 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 { parallelSearch, exaSearch } from './core.js';
|
||||
import { customSearch, freeSearch } from './core.js';
|
||||
|
||||
export const SERVER_NAME = 'web_search';
|
||||
export const VERSION = '1.0.0';
|
||||
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: 'Free web search tool. Uses Parallel by default or Exa as fallback. Returns an array of results with title, url, snippet, and publishedAt.',
|
||||
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' },
|
||||
provider: { type: 'string', enum: ['parallel', 'exa'], description: "Backend provider: 'parallel' (default) or 'exa' (fallback)" },
|
||||
numResults: { type: 'integer', minimum: 1, default: 8, description: 'Maximum number of results to return (default 8)' },
|
||||
},
|
||||
required: ['query'],
|
||||
@@ -28,8 +33,27 @@ const TOOLS = [
|
||||
},
|
||||
];
|
||||
|
||||
/** 执行一次 tools/call;失败时抛 { code, message } 表示工具级错误。 */
|
||||
async function callTool(name, args) {
|
||||
/** 从请求 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 ?? {};
|
||||
@@ -38,20 +62,33 @@ async function callTool(name, args) {
|
||||
: null;
|
||||
if (query === null) throw { code: -32602, message: 'query is required' };
|
||||
|
||||
const provider = params.provider === 'exa' ? 'exa' : 'parallel';
|
||||
const numResults = typeof params.numResults === 'number' && Number.isFinite(params.numResults)
|
||||
? Math.max(1, Math.floor(params.numResults))
|
||||
: 8;
|
||||
|
||||
const sources = provider === 'exa'
|
||||
? await exaSearch(query, numResults, process.env.EXA_API_KEY)
|
||||
: await parallelSearch(query, numResults);
|
||||
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) {
|
||||
async function handleRequest(message, headers) {
|
||||
switch (message.method) {
|
||||
case 'initialize':
|
||||
return {
|
||||
@@ -62,7 +99,7 @@ async function handleRequest(message) {
|
||||
case 'tools/list':
|
||||
return { tools: TOOLS };
|
||||
case 'tools/call':
|
||||
return callTool(message.params?.name, message.params?.arguments);
|
||||
return callTool(message.params?.name, message.params?.arguments, headers);
|
||||
case 'ping':
|
||||
return {};
|
||||
default:
|
||||
@@ -72,9 +109,11 @@ async function handleRequest(message) {
|
||||
|
||||
/**
|
||||
* 解析并执行一条 JSON 消息。
|
||||
* @param {string} raw JSON-RPC 文本
|
||||
* @param {object} [headers] 本次 HTTP 请求的 header(stdio 模式没有,上游参数就走免费后端)
|
||||
* @returns 响应信封对象;notification(无 id)返回 null;非法 JSON 返回 undefined。
|
||||
*/
|
||||
export async function dispatch(raw) {
|
||||
export async function dispatch(raw, headers) {
|
||||
let message;
|
||||
try {
|
||||
message = JSON.parse(raw);
|
||||
@@ -83,7 +122,7 @@ export async function dispatch(raw) {
|
||||
}
|
||||
if (message.id === undefined) return null; // 通知不响应
|
||||
try {
|
||||
return { jsonrpc: '2.0', id: message.id, result: await handleRequest(message) };
|
||||
return { jsonrpc: '2.0', id: message.id, result: await handleRequest(message, headers) };
|
||||
} catch (error) {
|
||||
const e = error;
|
||||
return {
|
||||
|
||||
Reference in New Issue
Block a user