- log.js 签名改为 log.xxx(category, ...args);头三段为时间戳 [level] [category],后续参数(含 Error/对象)透传 console 走 util.format
- 所有调用点迁移:从 log.info('[msg] xxx') → log.info('msg', 'xxx');server 启动行无前缀,统一归入 startup
- 实测输出:2026-09-05 09:27:12.068 [debug] [sse] task-20260904-012 event: ping
164 lines
7.9 KiB
JavaScript
164 lines
7.9 KiB
JavaScript
// 极简 MCP 客户端(Streamable HTTP:JSON-RPC over HTTP,无状态,响应可能是 SSE 帧包裹的 JSON)。
|
||
// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?}。
|
||
// 启动时 init() 对每个服务调 tools/list 发现工具,转成 OpenAI function 格式,
|
||
// 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型;
|
||
// 工具调用经 tools/call 转发给对应服务。
|
||
// 与内置工具严格分离:本模块不碰内置定义;MCP 工具默认沿用原始名,
|
||
// 仅当与内置工具或其他 MCP 工具重名时加「服务名__」前缀。
|
||
|
||
const log = require('./log');
|
||
|
||
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
||
const toolIndex = new Map(); // 发送名 -> { server, tool }(服务配置 + 原始工具名)
|
||
let builtinNames = new Set();
|
||
|
||
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
|
||
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
|
||
// 之后所有非 initialize 请求都必须带上该 header,否则返回 400。我们把会话 id 缓存在 server.sessionId 里。
|
||
// session 过期补偿:非 initialize 请求若 400 且错误信息含 session,清掉旧 id 并重新 initialize 后重试一次。
|
||
async function rpc(server, method, params, timeoutMs) {
|
||
const callId = Date.now();
|
||
const ctrl = new AbortController();
|
||
const timer = setTimeout(() => ctrl.abort(), timeoutMs || 30000);
|
||
try {
|
||
const headers = Object.assign({
|
||
'Content-Type': 'application/json',
|
||
'Accept': 'application/json, text/event-stream',
|
||
}, server.headers || {});
|
||
// initialize 请求自身不需要带 session id;其他请求如果该服务提供了 session id 则必须带
|
||
if (method !== 'initialize' && server.sessionId) headers['Mcp-Session-Id'] = server.sessionId;
|
||
const res = await fetch(server.url, {
|
||
method: 'POST',
|
||
signal: ctrl.signal,
|
||
headers,
|
||
body: JSON.stringify({ jsonrpc: '2.0', id: callId, method, params: params || {} }),
|
||
});
|
||
const raw = await res.text();
|
||
// 响应头里出现 Mcp-Session-Id 就缓存到 server(多处出现都被覆盖为最后一次,重复请求同一服务后保持一致)
|
||
const sid = res.headers.get('mcp-session-id');
|
||
if (sid) server.sessionId = sid;
|
||
if (!res.ok) {
|
||
// session 过期补偿:仅对非 initialize 请求,400 且错误信息含 session 时重新握手后重试一次。
|
||
// 不调 tools/list —— 工具表在 init() 时已经发现并固化,运行期间不需要重新发现。
|
||
if (method !== 'initialize' && res.status === 400 && /session/i.test(raw)) {
|
||
clearTimeout(timer);
|
||
log.warn('mcp', server.name + ' session 疑似过期,重新握手: ' + raw.slice(0, 200));
|
||
server.sessionId = null;
|
||
// 重新跑 initialize,递归走当前函数,method=initialize 不会再触发重连逻辑
|
||
try {
|
||
await rpc(server, 'initialize', {
|
||
protocolVersion: '2024-11-05',
|
||
capabilities: {},
|
||
clientInfo: { name: 'agent', version: '1.0.0' },
|
||
}, 15000);
|
||
// 按 MCP 规范发 notifications/initialized(无响应体,失败不阻断)
|
||
try { await rpc(server, 'notifications/initialized', {}, 5000); } catch (_) { /* 通知失败不阻断 */ }
|
||
} catch (e) {
|
||
// 老服务可能没有 initialize,会报 Method not found;不阻断,按既有兼容走原通道
|
||
if (!/Method not found/i.test(String(e && e.message || e))) throw e;
|
||
}
|
||
// 重试原请求(新一次 fetch + 新 AbortController)
|
||
return await rpc(server, method, params, timeoutMs);
|
||
}
|
||
throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300));
|
||
}
|
||
// 响应可能是 SSE 帧(多行 data: {...}),取 id 匹配或最后一条 JSON
|
||
let payload = null;
|
||
try {
|
||
payload = JSON.parse(raw);
|
||
} catch (_) {
|
||
for (const line of raw.split('\n')) {
|
||
const t = line.trim();
|
||
if (!t.startsWith('data:')) continue;
|
||
try {
|
||
const obj = JSON.parse(t.slice(5).trim());
|
||
if (!payload || obj.id === callId) payload = obj;
|
||
} catch (_) { /* 跳过非 JSON 帧 */ }
|
||
}
|
||
}
|
||
if (!payload) throw new Error('响应无法解析:' + raw.slice(0, 300));
|
||
if (payload.error) throw new Error('MCP 错误:' + JSON.stringify(payload.error).slice(0, 500));
|
||
return payload.result;
|
||
} finally {
|
||
clearTimeout(timer);
|
||
}
|
||
}
|
||
|
||
// 发现所有 MCP 服务的工具。单个服务失败只警告,不影响其他服务与内置工具。
|
||
// 对要求会话的服务,先发 initialize 拿到 Mcp-Session-Id,再发 notifications/initialized + tools/list。
|
||
async function init(cfg) {
|
||
toolDefs = [];
|
||
toolIndex.clear();
|
||
try {
|
||
for (const d of require('./tools/definitions.json')) {
|
||
if (d.function && d.function.name) builtinNames.add(d.function.name);
|
||
}
|
||
} catch (_) { /* 内置定义读不到就不做重名保护 */ }
|
||
|
||
const servers = (cfg && cfg.mcp_servers) || [];
|
||
for (const s of servers) {
|
||
// 清理上次会话 id(重启后服务端会拒绝旧 id;不清理会一直 400)
|
||
s.sessionId = null;
|
||
try {
|
||
// 先 initialize:兼容要求会话的服务。strict 模式下服务端会返回 session id;
|
||
// 不要求的服务也会正常响应(只是响应头里没有 mcp-session-id)。
|
||
try {
|
||
await rpc(s, 'initialize', {
|
||
protocolVersion: '2024-11-05',
|
||
capabilities: {},
|
||
clientInfo: { name: 'agent', version: '1.0.0' },
|
||
}, 15000);
|
||
// 按 MCP 规范:initialize 成功后发 notifications/initialized 通知(不需要 id,不期待响应体)
|
||
try { await rpc(s, 'notifications/initialized', {}, 5000); } catch (_) { /* 通知失败不阻断 */ }
|
||
} catch (e) {
|
||
// 某些老服务(无 initialize)会报 Method not found;不阻断,走原 tools/list 路径
|
||
if (!/Method not found/i.test(String(e && e.message || e))) throw e;
|
||
}
|
||
const result = await rpc(s, 'tools/list', {}, 15000);
|
||
const tools = (result && result.tools) || [];
|
||
for (const t of tools) {
|
||
if (!t || !t.name) continue;
|
||
let name = t.name;
|
||
if (builtinNames.has(name) || toolIndex.has(name)) name = s.name + '__' + name;
|
||
toolIndex.set(name, { server: s, tool: t.name });
|
||
toolDefs.push({
|
||
type: 'function',
|
||
function: {
|
||
name,
|
||
description: t.description || t.title || '',
|
||
parameters: t.inputSchema || t.input_schema || { type: 'object', properties: {} },
|
||
},
|
||
});
|
||
}
|
||
log.info('mcp', s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : ''));
|
||
} catch (err) {
|
||
log.warn('mcp', s.name + ' 工具发现失败(本轮运行该服务不可用): ' + (err && err.message || err));
|
||
}
|
||
}
|
||
}
|
||
|
||
// 随请求发送的 MCP 工具定义(追加在内置工具之后)。
|
||
function toolDefinitions() { return toolDefs; }
|
||
|
||
function hasTool(name) { return toolIndex.has(name); }
|
||
|
||
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
|
||
async function callTool(name, args) {
|
||
const entry = toolIndex.get(name);
|
||
if (!entry) return 'Error: 未知 MCP 工具 ' + name;
|
||
let result;
|
||
try {
|
||
result = await rpc(entry.server, 'tools/call', { name: entry.tool, arguments: args || {} }, 60000);
|
||
} catch (err) {
|
||
return 'MCP ' + entry.server.name + '/' + entry.tool + ' 调用失败: ' + (err && err.message || err);
|
||
}
|
||
const content = result && result.content;
|
||
if (Array.isArray(content)) {
|
||
const text = content.filter(c => c && c.type === 'text').map(c => c.text || '').join('\n');
|
||
if (text) return text;
|
||
}
|
||
return JSON.stringify(result).slice(0, 20000);
|
||
}
|
||
|
||
module.exports = { init, toolDefinitions, hasTool, callTool };
|