@codify-ai/mcp-client 1.0.19 → 1.0.24

package/dist/design-philosophy.md

@@ -0,0 +1,35 @@
+# 🧠 核心设计哲学 (Design Philosophy)
+
+### 1. 视觉风格与材质 (Visual Style & Material)
+
+**原则**：形式追随功能。所有的视觉决策（颜色、布局、材质）必须服务于用户的心理模型和业务目标。
+
+- **[未来与深度]** (偏前沿探索)：**磨砂玻璃特效** + **暗色模式**。利用光晕和透明度制造层级感。
+- **[效率与速度]** (偏专业工具)：**洁净扁平风格** + **便当盒布局 (Bento UI)**。强调清晰边界、模块化，减少装饰。
+- **[信任与专业]** (偏金融/严谨)：**瑞士极简风格**。大量留白 (Less Is More)，依托排版和严格网格传达严谨性。
+- **[关怀与共鸣]** (偏人文/生活)：**低饱和度自然色** + **极端圆角**。超柔和弥散阴影，传递呼吸感。
+- **[沉浸与表现]** (偏娱乐/叙事)：**拟物化材质** + **强对比情绪色彩**。打破常规网格，低信息密度。
+
+### 2. 空间与排版组织原则 (Spatial & Typography)
+
+- **密度层级**：密度与重要性成反比。核心重点区域需要低密度/大边距。数据列表需要高密度/小边距。
+- **排版系统**：
+- 优先使用 modern sans-serif fonts.
+- 标题和正文之间应建立显著的**字体粗细**和**字号**对比。
+- 正文行高保持为 `leading-[1.5]` 或 `leading-[1.6]`，以确保页面通透。
+
+### 3. 交互暗示与容错原则 (Affordance & Resilience)
+
+虽然输出的是静态 HTML，但在处理多项同类组件（如列表、导航、卡片组）时，**必须在同一个容器内，同时硬编码渲染出不同的交互状态**，以穷举展示组件的完整生命周期。
+
+- **⚠️ 警告**：不要仅仅依赖 Tailwind 的 `hover:` 伪类来实现交互。你必须通过直接改变特定 Item 的基础 class，让状态在静态截图中**同时可见**！
+
+### 4. 系统一致性约束 (System Integrity)
+
+**所有的设计决策必须映射到以下有限变量集（严禁出现奇数、小数 or 随机值）：**
+
+- **色彩系统 (Color System)**：主色定义品牌；主色**互补色**用于强引导；主色**同类色**用于柔引导。严禁随意取色。
+- **空间间距 (8-Point Grid)**：必须遵循 8pt 网格系统，间距与内边距仅限：`8` / `12` / `16` / `20` / `24` / `32` / `40` (严格应用到 gap 和 padding)。
+- **圆角控制 (Border Radius)**：根据风格选择，默认 `rounded-[12px]` 起步。
+- **尺寸底线 (Typography/Size)**：最小点击热区 `44px`；最小阅读字号 `12px` (仅限注释)，标准正文 `14px/16px`。
+- **阴影控制 (Shadows)**：必须使用弥散光影 如：`shadow-[0_10px_30px_rgba(0,0,0,0.08)]`，禁止生硬。

package/dist/index.js

@@ -0,0 +1,614 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync, existsSync, mkdirSync } from "fs";
+import path, { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { z } from "zod";
+import axios from "axios";
+import fs from "fs/promises";
+import { parse } from "node-html-parser";
+const __dirname$1 = dirname(fileURLToPath(import.meta.url));
+const generationRules = readFileSync(
+  resolve(__dirname$1, "rules.md"),
+  "utf-8"
+);
+const designPhilosophy = readFileSync(
+  resolve(__dirname$1, "design-philosophy.md"),
+  "utf-8"
+);
+const SERVER_URL = process.env.CODIFY_SERVER_URL || "http://localhost:8080";
+const ACCESS_KEY = process.env.CODIFY_ACCESS_KEY;
+const CODIFY_DOC_DIR = ".codify";
+const CODIFY_OUTPUT_DIR = ".codify-output";
+const isEmpty = (value) => value === null || value === void 0 || value === "" || typeof value === "string" && value.trim() === "";
+function buildSuccessText(result, actionName = "操作") {
+  let responseText = `✅ ${actionName}已成功完成`;
+  if (result.rootNodeId) responseText += `
+- 根节点 ID: ${result.rootNodeId}`;
+  if (result.documentId) responseText += `
+- 文档: ${result.documentName || ""} (${result.documentId})`;
+  if (result.documentPageId) responseText += `
+- 页面: ${result.documentPageName || ""} (${result.documentPageId})`;
+  return responseText;
+}
+async function callApi(method, endpoint, data = null) {
+  const headers = {};
+  if (ACCESS_KEY) headers["Authorization"] = `Bearer ${ACCESS_KEY}`;
+  const config = {
+    method,
+    url: `${SERVER_URL}${endpoint}`,
+    headers,
+    ...data && { data }
+  };
+  try {
+    const response = await axios(config);
+    return { data: response.data, error: null };
+  } catch (error) {
+    const status = error.response?.status;
+    const errorData = error.response?.data || {};
+    let message = errorData.message || error.message;
+    if (status === 401) message = "认证失败，请检查 CODIFY_ACCESS_KEY";
+    if (status === 403) {
+      if (errorData.mcp_get_limit !== void 0 || errorData.mcp_generate_limit !== void 0 || message.includes("limit")) {
+        message = `配额不足: ${message}`;
+      } else {
+        message = `权限不足: ${message}`;
+      }
+    }
+    if (status === 404) message = "未找到 API 终结点或活跃连接，请确保插件已打开";
+    return { data: null, error: { status, message, data: errorData } };
+  }
+}
+function parseResourcePath(resourcePath) {
+  const map = { image: "asset/images", svg: "asset/icons", shape: "asset/shapes" };
+  if (!isEmpty(resourcePath)) {
+    try {
+      const parsed = typeof resourcePath === "string" ? JSON.parse(resourcePath) : resourcePath;
+      if (parsed.image) map.image = parsed.image.replace(/^\.\//, "");
+      if (parsed.svg) map.svg = parsed.svg.replace(/^\.\//, "");
+      if (parsed.shape) map.shape = parsed.shape.replace(/^\.\//, "");
+    } catch (e) {
+    }
+  }
+  return map;
+}
+async function writeResource(resData, targetDir, folderName, ext) {
+  if (isEmpty(resData)) return 0;
+  const parsed = typeof resData === "string" ? JSON.parse(resData) : resData;
+  const keys = Object.keys(parsed);
+  if (keys.length === 0) return 0;
+  const resDir = path.join(targetDir, folderName);
+  if (!existsSync(resDir)) mkdirSync(resDir, { recursive: true });
+  const writePromises = Object.entries(parsed).map(async ([key, value]) => {
+    const match = key.match(/(.+)\.([a-zA-Z0-9]+)$/);
+    const safeKey = (match ? match[1] : key).replace(/[^a-zA-Z0-9_-]/g, "_");
+    const finalExt = match ? match[2] : ext;
+    const filePath = path.join(resDir, `${safeKey}.${finalExt}`);
+    let content = value;
+    if (typeof content === "string" && content.startsWith("http")) {
+      try {
+        const response = await axios.get(content, { responseType: "arraybuffer" });
+        await fs.writeFile(filePath, response.data);
+      } catch (err) {
+        console.error(`[Codify MCP] 资源下载失败 ${content}:`, err.message);
+      }
+    } else if (typeof content === "string" && content.startsWith("data:image/")) {
+      const parts = content.split(";base64,");
+      if (parts.length === 2) await fs.writeFile(filePath, parts[1], "base64");
+    } else {
+      const dataToWrite = typeof content === "object" ? JSON.stringify(content, null, 2) : content;
+      const encoding = finalExt === "png" || finalExt === "jpg" || finalExt === "jpeg" ? "base64" : "utf8";
+      await fs.writeFile(filePath, dataToWrite, encoding);
+    }
+  });
+  await Promise.all(writePromises);
+  return keys.length;
+}
+async function saveCodeAndResources({
+  baseDir,
+  outDir,
+  documentId,
+  documentPageId,
+  contentId,
+  nodeId,
+  nodeName,
+  code,
+  resourcePath,
+  shape,
+  svg,
+  image,
+  isSelection = false
+}) {
+  let targetDir = outDir ? path.resolve(baseDir, outDir) : documentId && documentPageId ? path.join(baseDir, CODIFY_DOC_DIR, String(documentId).replace(/:/g, "-"), String(documentPageId).replace(/:/g, "-"), contentId && !isSelection && !nodeId ? "code" : "") : isSelection ? path.join(baseDir, CODIFY_OUTPUT_DIR, "selection") : path.join(baseDir, `${CODIFY_OUTPUT_DIR}${contentId ? "/" + contentId : ""}`);
+  if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+  const safeId = String(nodeId || Date.now()).replace(/:/g, "-");
+  const safeName = String(nodeName || (isSelection ? "selection" : "node")).replace(/[^a-zA-Z0-9\u4e00-\u9fa5_-]/g, "-");
+  const htmlFileName = isSelection || nodeId || nodeName ? `${safeName}-${safeId}.html` : `${contentId || "index"}.html`;
+  const htmlPath = path.join(targetDir, htmlFileName);
+  if (code) {
+    await fs.writeFile(htmlPath, code, "utf8");
+  }
+  const resPathMap = parseResourcePath(resourcePath);
+  const stats = await Promise.all([
+    writeResource(shape, targetDir, resPathMap.shape, "json"),
+    writeResource(svg, targetDir, resPathMap.svg, "svg"),
+    writeResource(image, targetDir, resPathMap.image, "png")
+  ]);
+  return { targetDir, htmlFileName, htmlPath, shapeCount: stats[0], svgCount: stats[1], imageCount: stats[2], resourcePathMap: resPathMap };
+}
+const createComponentTool = {
+  name: "agent_create_component",
+  description: '创建一个 MasterGo 母版组件或组件集（变体）。应当使用 HTML 格式并包含 data-type="component" 属性。',
+  inputSchema: {
+    code: z.string().describe('组件的 HTML 结构。必须包含 data-type="component" 或 "component-set"。')
+  },
+  handler: async (args) => {
+    const { code } = args;
+    const { error } = await callApi("POST", "/api/createComponent", { code });
+    if (error) return { content: [{ type: "text", text: `❌ 创建失败: ${error.message}` }], isError: true };
+    return { content: [{ type: "text", text: "✅ 已成功向插件发送组件创建指令" }] };
+  }
+};
+const createPageTool = {
+  name: "agent_create_page",
+  description: "将代码发送到 Codify 插件转换为设计稿。若 HTML 已保存为本地文件，请通过 filePath 传入，避免大段 code 占用 Token。",
+  inputSchema: {
+    code: z.string().optional().describe("【可选】要发送的 HTML 代码内容。小片段可直接传此参数。"),
+    filePath: z.string().optional().describe("【可选】本地 HTML 文件的绝对路径。创建设计稿且文件已存在时，优先传此参数，工具会读取后发送并执行落盘。"),
+    projectDir: z.string().describe("【必填】用户当前工作区的根目录绝对路径"),
+    saveCodeToLocal: z.boolean().default(true).describe("是否将插件返回的渲染结果保存到本地 .codify 目录（落盘机制）")
+  },
+  handler: async (args) => {
+    const { projectDir, saveCodeToLocal = true } = args;
+    let code = args.code || "";
+    if (args.filePath) {
+      try {
+        const absolutePath = path.resolve(args.filePath);
+        code = await fs.readFile(absolutePath, "utf8");
+      } catch (e) {
+        return { content: [{ type: "text", text: `❌ 读取文件失败: ${e.message}` }], isError: true };
+      }
+    }
+    if (!code) return { content: [{ type: "text", text: "参数错误: 请提供 code 或 filePath" }], isError: true };
+    const cleanCode = code.replace(/<design_plan>[\s\S]*?<\/design_plan>/gi, "").trim();
+    const { data, error } = await callApi("POST", "/api/createPage", { code: cleanCode });
+    if (error) return { content: [{ type: "text", text: `❌ 发送失败: ${error.message}` }], isError: true };
+    let responseText = buildSuccessText(data, "设计稿生成");
+    if (saveCodeToLocal) {
+      try {
+        const baseDir = projectDir ? path.resolve(projectDir) : process.cwd();
+        const saveResult = await saveCodeAndResources({
+          baseDir,
+          code: data.htmlCode || code,
+          documentId: data.documentId,
+          documentPageId: data.documentPageId,
+          nodeId: data.rootNodeId,
+          nodeName: data.nodeName,
+          resourcePath: data.resourcePath,
+          shape: data.shape,
+          svg: data.svg,
+          image: data.image
+        });
+        responseText += `
+- 代码已本地持久化至: ${saveResult.htmlPath}`;
+      } catch (e) {
+        responseText += `
+- ⚠️ 本地保存失败: ${e.message}`;
+      }
+    }
+    return { content: [{ type: "text", text: responseText }] };
+  }
+};
+const designTool = {
+  name: "design",
+  description: "根据需求生成符合 Codify 规范的 HTML+CSS 代码",
+  inputSchema: {
+    requirement: z.string().describe('界面需求描述，例如："一个美观的登录页面"、"现代化的仪表盘界面"等。')
+  },
+  handler: async (args) => {
+    const { requirement } = args;
+    if (!requirement) {
+      return { content: [{ type: "text", text: "参数错误: 未提供需求描述" }], isError: true };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `📋 收到需求：${requirement}
+
+${generationRules}
+
+---
+
+## 发送代码：
+代码生成并审计通过后，请立即调用 agent_create_page 工具发送代码
+   - agent_create_page({ code: "生成的完整代码", projectDir: "当前工作目录" })
+   - 不要询问用户，直接执行发送操作
+
+**请现在开始生成代码。**`
+        }
+      ]
+    };
+  }
+};
+const getCodeTool = {
+  name: "get_code",
+  description: "从 Codify For MasterGo 插件获取指定的代码",
+  inputSchema: {
+    contentId: z.string().describe("从Codify插件复制图层的指令"),
+    documentId: z.string().optional().describe("当前 MasterGo 文档 ID。"),
+    documentPageId: z.string().optional().describe("当前 MasterGo 页面 ID。"),
+    projectDir: z.string().describe("【必填】用户当前工作区的根目录绝对路径"),
+    outDir: z.string().describe("【必填】保存代码和资源的绝对路径")
+  },
+  handler: async (args) => {
+    const { contentId, outDir, projectDir, documentId, documentPageId } = args;
+    if (!contentId) return { content: [{ type: "text", text: "参数错误: 未提供 contentId" }], isError: true };
+    const { data, error } = await callApi("GET", `/api/getCode/${contentId}`);
+    if (error) return { content: [{ type: "text", text: `❌ 获取失败: ${error.message}` }], isError: true };
+    if (!data.code) return { content: [{ type: "text", text: "⚠️ 未找到代码内容" }] };
+    const baseDir = projectDir ? path.resolve(projectDir) : process.cwd();
+    const saveResult = await saveCodeAndResources({
+      baseDir,
+      outDir,
+      documentId,
+      documentPageId,
+      contentId,
+      code: data.code,
+      resourcePath: data.resourcePath,
+      shape: data.shape,
+      svg: data.svg,
+      image: data.image
+    });
+    let resultText = `✅ 代码拉取完成
+- 目录: ${saveResult.targetDir}
+- 文件: ${saveResult.htmlFileName}
+`;
+    if (saveResult.shapeCount > 0) resultText += `- Shape: ${saveResult.shapeCount} 个
+`;
+    if (saveResult.svgCount > 0) resultText += `- SVG: ${saveResult.svgCount} 个
+`;
+    if (saveResult.imageCount > 0) resultText += `- Image: ${saveResult.imageCount} 个
+`;
+    return { content: [{ type: "text", text: resultText }] };
+  }
+};
+const getCodeListTool = {
+  name: "get_code_list",
+  description: "获取所有可用的代码列表",
+  inputSchema: z.object({}).describe("无需参数获取代码列表"),
+  handler: async () => {
+    const { data, error } = await callApi("GET", "/api/getCodeList");
+    if (error) return { content: [{ type: "text", text: `❌ 获取失败: ${error.message}` }], isError: true };
+    if (!Array.isArray(data) || data.length === 0) {
+      return { content: [{ type: "text", text: "📋 代码列表为空" }] };
+    }
+    let resultText = `✅ 成功获取代码列表 (共 ${data.length} 项)
+
+`;
+    data.forEach((item, index) => {
+      resultText += `${index + 1}. **${item.contentId}**
+`;
+      resultText += `   - 长度: ${item.codeLength} 字符 | 创建于: ${item.createdAt || "未知"}
+
+`;
+    });
+    return { content: [{ type: "text", text: resultText }] };
+  }
+};
+const getSelectionCodeTool = {
+  name: "get_selection_code",
+  description: "获取 MasterGo 中当前选中图层（或指定图层）的代码，并智能落盘到本地 .codify 目录。\n\n【强制触发场景】凡用户说「将选中的 xxx 改成 yyy」「将选中的按钮改成红色」「修改当前选中的图层」等含「选中」的修改指令，你必须首先调用此工具拉取当前画布选中节点的最新代码，再根据返回的 HTML 进行修改，禁止凭空生成或直接修改本地文件。",
+  inputSchema: {
+    projectDir: z.string().describe("【必填】用户当前工作区的根目录绝对路径"),
+    id: z.string().optional().describe("【选填】MasterGo图层ID (例如 123:456)。如果提供，将直接拉取该ID的代码；如果不提供，将拉取当前选中图层的代码。")
+  },
+  handler: async (args) => {
+    const { projectDir, id } = args;
+    const endpoint = id ? `/api/getSelectionCode?id=${encodeURIComponent(id)}` : "/api/getSelectionCode";
+    const { data, error } = await callApi("GET", endpoint);
+    if (error) {
+      if (error.status === 400 && error.data?.error === "NoSelection") {
+        return { content: [{ type: "text", text: "❌ 获取失败: 没有选中任何图层。请先在 MasterGo 中选中一个图层。" }], isError: true };
+      }
+      return { content: [{ type: "text", text: `❌ 获取失败: ${error.message}` }], isError: true };
+    }
+    const baseDir = projectDir ? path.resolve(projectDir) : process.cwd();
+    const nodeInfo = data.nodeInfo || {};
+    const { rootId, documentId, documentPageId, nodeId, nodeName, parentId } = nodeInfo;
+    if (!parentId || parentId === "null") {
+      const saveResult = await saveCodeAndResources({
+        baseDir,
+        documentId,
+        documentPageId,
+        nodeId: rootId || nodeId,
+        // 使用 rootId 作为文件名后缀
+        nodeName,
+        code: data.code,
+        resourcePath: data.resourcePath,
+        shape: data.shape,
+        svg: data.svg,
+        image: data.image
+      });
+      console.log("saveResult", saveResult);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `✅ 成功获取并保存根节点代码
+- 节点: ${nodeName} (${nodeId})
+- 文件: ${saveResult.htmlPath}
+
+请查看该文件了解当前结构。`
+          }
+        ]
+      };
+    } else {
+      if (!documentId || !documentPageId) {
+        return { content: [{ type: "text", text: `❌ 更新失败: 缺少 documentId 或 documentPageId 信息。` }], isError: true };
+      }
+      const targetDir = path.join(baseDir, CODIFY_DOC_DIR, String(documentId).replace(/:/g, "-"), String(documentPageId).replace(/:/g, "-"));
+      if (!existsSync(targetDir)) {
+        return { content: [{ type: "text", text: `❌ 更新失败: 找不到根节点所在目录 ${targetDir}。请先选中并获取根节点的代码。` }], isError: true };
+      }
+      const files = await fs.readdir(targetDir);
+      const safeRootId = String(rootId).replace(/:/g, "-");
+      const rootFile = files.find((f) => f.endsWith(`-${safeRootId}.html`));
+      if (!rootFile) {
+        return { content: [{ type: "text", text: `❌ 更新失败: 在目录中找不到包含根节点 ID (${rootId}) 的文件。请先选中并获取根节点的代码。` }], isError: true };
+      }
+      const rootFilePath = path.join(targetDir, rootFile);
+      const htmlContent = await fs.readFile(rootFilePath, "utf8");
+      const rootNode = parse(htmlContent);
+      const targetElement = rootNode.querySelector(`[data-node-id="${nodeId}"]`);
+      if (targetElement) {
+        targetElement.replaceWith(data.code);
+      } else if (nodeInfo.parentId) {
+        const parentElement = rootNode.querySelector(`[data-node-id="${nodeInfo.parentId}"]`);
+        if (parentElement) {
+          parentElement.insertAdjacentHTML("beforeend", data.code);
+        } else {
+          return { content: [{ type: "text", text: `❌ 更新失败: 在文件 ${rootFile} 中找不到当前节点(${nodeId})，也找不到父节点(${nodeInfo.parentId})。` }], isError: true };
+        }
+      } else {
+        return { content: [{ type: "text", text: `❌ 更新失败: 在文件 ${rootFile} 中找不到 data-node-id="${nodeId}" 的元素，且未提供 parentId 作为后备。` }], isError: true };
+      }
+      await fs.writeFile(rootFilePath, rootNode.toString(), "utf8");
+      await saveCodeAndResources({
+        baseDir,
+        documentId,
+        documentPageId,
+        nodeId,
+        nodeName,
+        code: "",
+        // 我们已经手动更新了 HTML，这里传空字符串，主要是为了利用它去保存资源
+        resourcePath: data.resourcePath,
+        shape: data.shape,
+        svg: data.svg,
+        image: data.image
+      }).catch((e) => console.error("保存子节点资源失败:", e));
+      return {
+        content: [
+          {
+            type: "text",
+            text: `✅ 成功更新子节点代码
+- 节点: ${nodeName} (${nodeId})
+- 已更新文件: ${rootFilePath}`
+          }
+        ]
+      };
+    }
+  }
+};
+const getUserInfoTool = {
+  name: "get_user_info",
+  description: "获取当前登录用户的信息，包括配额、团队等",
+  inputSchema: z.object({}).describe("获取当前用户信息"),
+  handler: async () => {
+    const { data, error } = await callApi("GET", "/api/getUserInfo");
+    if (error) return { content: [{ type: "text", text: `❌ 获取失败: ${error.message}` }], isError: true };
+    let resultText = `✅ 用户信息
+
+👤 用户: ${data.realname || data.userName || data.userId}
+`;
+    if (data.quota) {
+      resultText += `
+📊 配额:
+`;
+      resultText += `  - 生成设计: ${data.quota.mcp_generate_count || 0} / ${data.quota.mcp_generate_limit || "无"}
+`;
+      resultText += `  - 获取代码: ${data.quota.mcp_get_count || 0} / ${data.quota.mcp_get_limit || "无"}
+`;
+    }
+    if (data.teams?.length) {
+      resultText += `
+👥 团队:
+`;
+      data.teams.forEach((t, i) => resultText += `  ${i + 1}. ${t.name} (ID: ${t.teamId})
+`);
+    }
+    return { content: [{ type: "text", text: resultText }] };
+  }
+};
+const updateNodeTool = {
+  name: "agent_update_node",
+  description: '将修改后的 HTML 代码发回 MasterGo 画布进行更新。\n\n【调用前置条件】若用户说的是「将选中的 xxx 改成 yyy」等含「选中」的修改指令，你必须先调用 get_selection_code 拉取当前选中节点代码，修改完成后再调用本工具，不得跳过前置步骤。\n\n【局部修改（改文字/颜色/某处）】只传你改动的那一个节点（含 data-node-id 及子节点）的 HTML 片段到 code 参数，严禁传整个文件。\n\n【全量同步（用户明确说"同步到设计稿"）】才用 filePath 传本地文件绝对路径，禁止用 Read 工具读大文件再塞进 code。\n\n若是从 Vue/React 业务代码同步，请剔除框架指令（v-for、@click 等），只传纯 HTML。',
+  inputSchema: {
+    documentId: z.string().optional().describe("当前 MasterGo 文档 ID。"),
+    documentPageId: z.string().optional().describe("当前 MasterGo 页面 ID。"),
+    targetNodeId: z.string().optional().describe("【选填】目标图层 ID (例如 123:456)。如果不传，则默认更新 MasterGo 中当前选中的图层。"),
+    code: z.string().optional().describe("【可选】修改后的 HTML 代码片段。如果只是局部小修改，可以直接传代码。"),
+    filePath: z.string().optional().describe("【可选】如果需要发送整个文件或大量代码，请提供该文件的绝对路径，工具会自动读取并发送，绝对不要把整个文件的代码塞进 code 参数里！")
+  },
+  handler: async (args) => {
+    const { targetNodeId, documentId, documentPageId, filePath } = args;
+    let finalCode = args.code || "";
+    if (filePath) {
+      try {
+        const absolutePath = path.resolve(filePath);
+        finalCode = await fs.readFile(absolutePath, "utf8");
+      } catch (e) {
+        return { content: [{ type: "text", text: `❌ 读取文件失败: ${e.message}` }], isError: true };
+      }
+    }
+    if (!finalCode) {
+      return { content: [{ type: "text", text: `❌ 必须提供 code 或 filePath` }], isError: true };
+    }
+    const { data, error } = await callApi("POST", "/api/updateNode", { code: finalCode, targetNodeId, documentId, documentPageId });
+    if (error) return { content: [{ type: "text", text: `❌ 更新失败: ${error.message}` }], isError: true };
+    return {
+      content: [{ type: "text", text: `✅ 已成功发送更新指令${data.nodeId ? `
+- 结果节点 ID: ${data.nodeId}` : ""}
+
+⚠️ 强烈建议：为了保证本地 .codify 目录中的基准 HTML 与设计稿保持一致，请立即调用 get_selection_code 工具（传入对应的根节点 ID），拉取最新的纯净 HTML 并覆盖本地基准文件。` }]
+    };
+  }
+};
+const getDesignDiffTool = {
+  name: "get_design_diff",
+  description: "获取最新设计稿代码与本地 .codify 目录中旧代码的差异 (Diff)。当用户要求“同步设计稿到业务代码”或“对比最新设计稿”时使用。注意：拿到差异后，请根据 data-node-id 精准修改用户的业务代码，绝对不要破坏原有的框架逻辑（如 Vue/React 指令）。",
+  inputSchema: {
+    projectDir: z.string().describe("【必填】用户当前工作区的根目录绝对路径"),
+    id: z.string().optional().describe("【选填】MasterGo图层ID (例如 123:456)。如果不传，则默认获取当前选中图层的代码进行对比。")
+  },
+  handler: async (args) => {
+    const { projectDir, id } = args;
+    const baseDir = projectDir ? path.resolve(projectDir) : process.cwd();
+    let oldHtml = "";
+    let localFilePath = "";
+    if (id) {
+      const safeId = String(id).replace(/:/g, "-");
+      const findFile = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+          const fullPath = path.join(dir, entry.name);
+          if (entry.isDirectory()) {
+            const found = await findFile(fullPath);
+            if (found) return found;
+          } else if (entry.name.endsWith(`-${safeId}.html`)) {
+            return fullPath;
+          }
+        }
+        return null;
+      };
+      const codifyDir = path.join(baseDir, CODIFY_DOC_DIR);
+      if (existsSync(codifyDir)) {
+        localFilePath = await findFile(codifyDir) || "";
+        if (localFilePath) {
+          oldHtml = await fs.readFile(localFilePath, "utf8");
+        }
+      }
+    }
+    if (!oldHtml) {
+      return {
+        content: [{
+          type: "text",
+          text: id ? `❌ 在本地 .codify 目录中找不到 ID 为 ${id} 的代码文件。请确保已执行过拉取操作。` : `❌ 请提供图层 ID 以便从本地 .codify 目录加载基准代码进行 Diff。`
+        }],
+        isError: true
+      };
+    }
+    const { data, error } = await callApi("POST", "/api/getDesignDiff", {
+      code: oldHtml,
+      id
+    });
+    if (error) {
+      return { content: [{ type: "text", text: `❌ 获取设计稿差异失败: ${error.message}` }], isError: true };
+    }
+    const diffs = data.diffs || [];
+    if (diffs.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `✅ 设计稿与本地代码完全一致，没有发现任何变更。`
+          }
+        ]
+      };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `✅ 成功获取设计稿差异 (共 ${diffs.length} 处变更)：
+
+\`\`\`json
+${JSON.stringify(diffs, null, 2)}
+\`\`\`
+
+请根据以上 Diff 数据，结合 data-node-id，将变更合并到用户的业务代码（无论是 Vue、React、原生代码）和 .codify 的基准文件。`
+        }
+      ]
+    };
+  }
+};
+const allTools = [
+  designTool,
+  getCodeTool,
+  getCodeListTool,
+  getUserInfoTool,
+  createPageTool,
+  createComponentTool,
+  getSelectionCodeTool,
+  updateNodeTool,
+  getDesignDiffTool
+];
+function registerAllTools(mcpServer2) {
+  allTools.forEach((tool) => {
+    mcpServer2.registerTool(tool.name, {
+      description: tool.description,
+      inputSchema: tool.inputSchema
+    }, tool.handler);
+  });
+}
+const mcpServer = new McpServer(
+  {
+    name: "Codify-MCP-Client",
+    version: "1.0.22"
+  },
+  {
+    capabilities: {
+      resources: {},
+      tools: {},
+      prompts: {}
+    }
+  }
+);
+mcpServer.registerResource(
+  "generation-rules",
+  "codify://generation-rules",
+  { description: "Codify 逆向转译协议（必须严格遵守的 HTML/Tailwind 语法规范）" },
+  async (uri) => ({
+    contents: [
+      {
+        uri: uri.toString(),
+        text: generationRules,
+        mimeType: "text/markdown"
+      }
+    ]
+  })
+);
+mcpServer.registerResource(
+  "design-philosophy",
+  "codify://design-philosophy",
+  { description: "Codify 核心设计哲学（仅在从零设计新页面或重构 UI 风格时加载，用于指导商业级审美）" },
+  async (uri) => ({
+    contents: [
+      {
+        uri: uri.toString(),
+        text: designPhilosophy,
+        mimeType: "text/markdown"
+      }
+    ]
+  })
+);
+registerAllTools(mcpServer);
+try {
+  const transport = new StdioServerTransport();
+  await mcpServer.connect(transport);
+  console.error(`[Codify MCP] Client connected to ${SERVER_URL}`);
+} catch (error) {
+  console.error(`[Codify MCP] Connection failed:`, error.message);
+  process.exit(1);
+}