Files
agent/app/server/mcp.js
T
kicer 1023ffa8fd 修复 MCP 工具调用 400:image-gen 等严格服务要求 initialize 后的请求带 Mcp-Session-Id。
init() 阶段先发 initialize 拿 session id 并缓存到 server.sessionId;
rpc() 在 method !== 'initialize' 且 server.sessionId 存在时自动加上 Mcp-Session-Id 头;
老服务(无 initialize 或不返回 session id)保持原行为不受影响
2026-09-04 13:17:23 +08:00

139 lines
6.4 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 极简 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 里。
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) 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 };