/** * MCP 工具单元测试 * 覆盖:工具注册完整性、删除两步式确认、只读模式下拒绝写操作 * 运行:npm test */ const test = require("node:test"); const assert = require("node:assert"); const { createMcpServer } = require("../src/mcp/tools"); const { loadSystem, saveSystem } = require("../src/persistence/jsonAdapter"); // 恢复测试前的系统模式,避免影响其他用例 const originalMode = (loadSystem() || {}).mode || "edit"; test.after(() => { const system = loadSystem() || {}; system.mode = originalMode; saveSystem(system); }); let server; test.before(() => { server = createMcpServer(); }); /** * 直接调用已注册工具的处理函数 * @param {string} name - 工具名 * @param {Object} args - 工具参数 * @returns {Promise} 工具结果 */ async function callTool(name, args) { const tool = server._registeredTools[name]; assert.ok(tool, `工具不存在: ${name}`); try { const result = await tool.handler(args, {}); return { text: (result.content || []).map((c) => c.text).join("\n"), structuredContent: result.structuredContent, isError: result.isError === true, }; } catch (err) { // 直接调用底层 handler 时,抛错不会自动转换为 isError 结果,这里统一转换 return { text: err && err.message ? err.message : String(err), structuredContent: { error: true }, isError: true, }; } } test("注册了全部项目/配置 CRUD 及确认删除工具", () => { const names = new Set(Object.keys(server._registeredTools)); for (const name of [ "get_mode", "set_mode", "list_projects", "get_project", "create_project", "update_project_mappings", "delete_project", "confirm_delete_project", "list_configs", "get_config", "create_config", "update_config", "delete_config", "confirm_delete_config", ]) { assert.ok(names.has(name), `缺少工具: ${name}`); } }); test("删除项目为两步式:先登记待确认,确认后才真正删除", async () => { const { text: createText } = await callTool("create_project", { name: "MCP-Unittest-Proj", }); const project = JSON.parse(createText.match(/\{[\s\S]*\}/)[0]); const pid = project.id; const del = await callTool("delete_project", { projectId: pid }); assert.strictEqual(del.structuredContent.status, "awaiting_confirmation"); assert.ok(del.structuredContent.confirmation_token); // 未确认前项目仍然存在 const stillThere = await callTool("get_project", { projectId: pid }); assert.ok(!stillThere.isError); // 确认后项目被删除 const confirm = await callTool("confirm_delete_project", { confirmation_token: del.structuredContent.confirmation_token, }); assert.strictEqual(confirm.structuredContent.status, "deleted"); const gone = await callTool("get_project", { projectId: pid }); assert.ok(gone.isError, "确认删除后项目应不存在"); }); test("重复使用确认令牌会失败(一次性令牌)", async () => { const { text: createText } = await callTool("create_project", { name: "MCP-Unittest-Token" }); const project = JSON.parse(createText.match(/\{[\s\S]*\}/)[0]); const del = await callTool("delete_project", { projectId: project.id }); const tok = del.structuredContent.confirmation_token; await callTool("confirm_delete_project", { confirmation_token: tok }); const second = await callTool("confirm_delete_project", { confirmation_token: tok }); assert.ok(second.isError); assert.strictEqual(second.structuredContent.status, "invalid_or_expired"); }); test("readonly 模式下拒绝项目/配置写操作,切换回 edit 后恢复", async () => { await callTool("set_mode", { mode: "readonly" }); const createProject = await callTool("create_project", { name: "不应创建" }); assert.ok(createProject.isError); assert.match(createProject.text, /只读模式/); const delProject = await callTool("delete_project", { projectId: "proj-mrlip49o-qsr2yx" }); assert.ok(delProject.isError); assert.match(delProject.text, /只读模式/); const createConfig = await callTool("create_config", { projectId: "proj-mrlip49o-qsr2yx", key: "x", description: "x", }); assert.ok(createConfig.isError); assert.match(createConfig.text, /只读模式/); await callTool("set_mode", { mode: "edit" }); }); test("配置删除同样为两步式确认", async () => { const { text: createText } = await callTool("create_project", { name: "MCP-Unittest-Cfg" }); const project = JSON.parse(createText.match(/\{[\s\S]*\}/)[0]); const cfg = await callTool("create_config", { projectId: project.id, key: "a/b", description: "unit", value: "1", type: "number", }); const cfgObj = JSON.parse(cfg.text.match(/\{[\s\S]*\}/)[0]); const del = await callTool("delete_config", { projectId: project.id, configId: cfgObj.id }); assert.strictEqual(del.structuredContent.status, "awaiting_confirmation"); const confirm = await callTool("confirm_delete_config", { confirmation_token: del.structuredContent.confirmation_token, }); assert.strictEqual(confirm.structuredContent.status, "deleted"); // 清理测试项目 const delProject = await callTool("delete_project", { projectId: project.id }); const confirmProject = await callTool("confirm_delete_project", { confirmation_token: delProject.structuredContent.confirmation_token, }); assert.strictEqual(confirmProject.structuredContent.status, "deleted"); });