/** * IPC MCP Handlers — MCP 服务管理域(P2-9 从 handlers.ts 拆分) */ import { ipcMain } from 'electron'; import type { IPCContext } from './context'; import log from 'electron-log'; import { assertSafeConfigTarget } from '../harness/tools/built-in/ssrf-guard'; export function registerMCPHandlers(ctx: IPCContext): void { const { mcpManager } = ctx; ipcMain.handle('mcp:listServers', async () => { return mcpManager.getServerStates(); }); ipcMain.handle( 'mcp:addServer', async ( _event, config: { name: string; transport: string; command?: string; args?: string[]; url?: string; headers?: Record; }, ) => { // M-38 修复: 完整参数校验,防止字段缺失或类型不符导致异常行为 if (!config || typeof config !== 'object') { return { success: false, error: 'Invalid config' }; } if (typeof config.name !== 'string' || !config.name.trim()) { return { success: false, error: 'Server name is required' }; } // M-5 修复: transport 运行时校验(替代 as 断言) // v0.4.1: 新增 'streamable-http' 传输方式 if ( config.transport !== 'stdio' && config.transport !== 'sse' && config.transport !== 'streamable-http' ) { return { success: false, error: `Invalid transport: ${config.transport}. Must be 'stdio', 'sse', or 'streamable-http'`, }; } // stdio 类型必须有 command if ( config.transport === 'stdio' && (typeof config.command !== 'string' || !config.command.trim()) ) { return { success: false, error: 'command is required for stdio transport' }; } // sse / streamable-http 类型必须有合法 url if (config.transport === 'sse' || config.transport === 'streamable-http') { if (typeof config.url !== 'string' || !config.url.trim()) { return { success: false, error: `url is required for ${config.transport} transport` }; } try { new URL(config.url); } catch { return { success: false, error: 'Invalid url format' }; } // v0.7.4 P2-9: 配置类 URL 高危目标校验(云元数据/链路本地/组播/保留段拦截; // 本地回环与私网实例放行——本地 MCP server 是合法用例) try { assertSafeConfigTarget(config.url); } catch (err) { return { success: false, error: (err as Error).message }; } } // v0.7.2 P2-8: headers 校验 —— 可选,必须是扁平的 string→string 对象。 // 上限约束(≤20 项、键 ≤128 字符、值 ≤4096 字符)防止把 headers // 当作数据通道滥用;非法条目整体拒绝而非静默丢弃(配置期显式失败)。 if (config.headers !== undefined) { if ( !config.headers || typeof config.headers !== 'object' || Array.isArray(config.headers) ) { return { success: false, error: 'headers must be an object of string key-value pairs', }; } const entries = Object.entries(config.headers as Record); if (entries.length > 20) { return { success: false, error: 'headers supports at most 20 entries' }; } for (const [k, v] of entries) { if (typeof k !== 'string' || !k.trim() || k.length > 128) { return { success: false, error: `Invalid header name: ${String(k).slice(0, 40)}` }; } if (typeof v !== 'string' || v.length > 4096) { return { success: false, error: `Invalid header value for "${k.slice(0, 40)}"` }; } } } try { await mcpManager.addServer({ name: config.name, transport: config.transport, // 已校验,无需断言 command: config.command, args: config.args, url: config.url, headers: config.headers as Record | undefined, // 已逐项校验 enabled: true, }); log.info(`MCP server added: ${config.name}`); return { success: true }; } catch (error) { return { success: false, error: error instanceof Error ? error.message : String(error) }; } }, ); ipcMain.handle('mcp:removeServer', async (_event, name: string) => { // M-38 修复: name 校验 if (typeof name !== 'string' || !name.trim()) { return { success: false, error: 'Invalid server name' }; } try { await mcpManager.removeServer(name); return { success: true }; } catch (error) { return { success: false, error: error instanceof Error ? error.message : String(error) }; } }); ipcMain.handle('mcp:toggleServer', async (_event, name: string, enabled: boolean) => { // M-38 修复: name 和 enabled 校验 if (typeof name !== 'string' || !name.trim()) { return { success: false, error: 'Invalid server name' }; } if (typeof enabled !== 'boolean') { return { success: false, error: 'Invalid enabled flag' }; } try { await mcpManager.toggleServer(name, enabled); return { success: true }; } catch (error) { return { success: false, error: error instanceof Error ? error.message : String(error) }; } }); // ===== v0.8.0 P2-5: MCP Resources / Prompts 发现 ===== ipcMain.handle('mcp:listServerContents', async (_event, name: unknown) => { if (typeof name !== 'string' || !name.trim()) { return { success: false, error: 'Invalid server name' }; } return { success: true, data: mcpManager.getServerContents(name) }; }); }