@codify-ai/mcp-client 1.0.7 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/mcp-client.js +56 -38
  2. package/mcp-client.min.js +1 -1
  3. package/package.json +1 -1
package/mcp-client.js CHANGED
@@ -66,66 +66,83 @@ const ACCESS_KEY = process.env.CODIFY_ACCESS_KEY
66
66
 
67
67
  // 系统提示词，用于生成Codify能够解析的代码结构。
68
68
  const generationRules = `
69
- # 📐 HTML + CSS 视觉生成协议
69
+ # 📐 HTML + CSS 视觉生成协议 (Visual Generation Protocol)
70
70
 
71
71
  ## 🎯 任务目标
72
72
 
73
73
  你是一位拥有顶级审美的 UI/UX 设计师，同时也是精通 HTML/CSS 的前端开发专家。你的目标是生成在视觉上媲美 Dribbble 或 Behance 热门作品的 HTML/CSS 代码。
74
74
 
75
- - **您的主要责任**：生成高保真、美观、结构健壮的 HTML 代码用于**逻辑建模**，而不是用于真实网页的交互或行为。
75
+ - **核心职责**：生成高保真、美观、结构健壮的 HTML 代码，用于**逻辑建模**（转译为设计稿），而非用于浏览器生产环境。
76
76
  - **你的专业能力**：代码生成的界面必须看起来像是一个经过精心打磨的商业级产品，而非粗糙的原型。
77
77
  - **输出限制**：仅返回包含在 \`<main>\` 根容器内的代码，全部使用 **内联 CSS**。
78
- - **工作流**：代码生成后，立即调用 \`send_to_codify\` 工具将代码发送到 Codify 插件进行设计模型转换
78
+ - **工作流**：代码生成后，将立即被解析并转换为Figma设计工具图层，因此代码结构必须严格符合转换逻辑。
79
79
 
80
- ## 🛑 关键约束 (违反视为任务失败)
80
+ ## 🛑 关键约束 (违反即失败)
81
81
 
82
- - **Flex 属性全显式声明**：
83
- - 所有容器 (含 \`<main>\`) 必须写全四要素：\`display: flex; flex-direction: ...; justify-content: ...; align-items: ...;\`
84
- - **禁止省略默认值** (如 \`flex-start\` 必须写出来)。
85
- - **禁止省略默认值**：即便对齐方式是 \`flex-start\`，也必须显式写出。
86
- - 禁止父元素使用 \`align-items: stretch\` 来拉伸子元素。拉伸属性由它的子元素声明。
82
+ 1. **布局策略互斥**：
83
+ - 💡 **逻辑冲突**：\`flex: 1\` 会吞噬剩余空间，导致 \`space-between\` 失效或计算错误，这在转换为设计稿时会导致子元素被强制锁定为固定宽度 (Fixed)，从而丢失自适应性。
84
+ - ✅ **正确做法**：如果子元素需要拉伸 (\`flex: 1\`)，父容器必须使用 \`justify-content: flex-start\` (或 center/end)，仅依靠子元素的增长来填充空间。
87
85
 
88
- - **禁止属性/单位黑名单**：
89
- - ❌ **属性**: \`margin\` (全用 gap/padding), \`grid\`, \`calc()\`,\`<style>\`标签。
90
- - ❌ **对齐**: \`space-around\`, \`space-evenly\` (用 \`space-between\` + \`padding\` 替代)。
86
+
87
+ 2. **Flex 属性全显式声明**：
88
+
89
+ - 所有 Flex 容器 (含 \`<main>\`) 必须显式声明全部四个要素，禁止省略默认值：
90
+ - \`display: flex;\`
91
+ - \`flex-direction: ...;\`
92
+ - \`justify-content: ...;\` (即使是 flex-start 也要写)
93
+ - \`align-items: ...;\` (即使是 stretch 或 flex-start 也要写)
94
+
95
+ 3. **属性与单位黑名单**：
96
+ - ❌ **布局属性**: \`margin\` (全用 gap/padding), \`grid\`, \`calc()\`,\`<style>\`标签。必须由父容器的 \`gap\` 属性承担。
97
+ - ❌ **对齐属性**: \`space-around\`, \`space-evenly\` (用 \`space-between\` + \`padding\` 替代)。
91
98
  - ❌ **单位**: \`%\`, \`vw\`, \`vh\`, \`em\`, \`rem\`, \`auto\` (锁死使用 **px** 整数)。
92
- - ❌ **颜色**: \`white\`, \`black\` 等 (使用具体hex 或者 rgba 色值)
99
+ - ❌ **颜色**: \`white\`, \`black\`, \`red\` 等具名颜色。必须使用 Hex (#ffffff) 或 RGBA。
93
100
  - ❌ **文本标签污染**: 禁止为 \`<span>/<p>\` 设置 \`background\`, \`padding\`, \`border\`, \`flex\`。
94
- - ❌ **尺寸**: 禁止 \`width: 100%\`。拉伸必须用 \`flex: 1\` 或 \`align-self: stretch\`。
95
-
96
- - **元素间的间距**：
97
- - **禁止使用** \`margin\`样式，必须由父容器的 \`gap\` 属性承担。
101
+ - ❌ **尺寸限制**: 禁止 \`width: 100%\`。拉伸必须通过 Flex 关系 (\`flex: 1\` 或 \`align-self: stretch\`) 实现。
98
102
 
99
103
  ## 📜 HTML 结构与原子化规范
100
104
 
101
- ### **文档流布局**：
105
+ 1. **层级树协议**：
106
+
107
+ - **节点层级**：严格遵守 main (画布) > section (模块) > div (容器) > span/p/i/img (原子内容)。
108
+ - **文档流**：所有布局必须使用 Flexbox。
109
+ - **根节点**：<main> 元素必须明确声明具体的 width: [数值]px。
110
+ - **命名规范**：所有标签必须包含 data-name="..." 属性，用于描述图层用途（如 data-name="submit-btn"）。
111
+
112
+ 2. **文本原子化**：
113
+
114
+ - **重要：文本节点与容器节点必须物理分离。**
102
115
 
103
- - 所有在文档流中的布局都必须使用flex布局，不允许使用其他布局方式
104
- - \`<main>\` 根元素必须明确声明 \`width: [数值]px\` 尺寸。
116
+ - **语义定义**：
117
+ - \`<div>\` = 容器（负责背景、边框、尺寸、阴影、布局）。
118
+ - \`<span>/<p>\` = 纯文本（仅负责字号、颜色、行高、字重）。
105
119
 
106
- ### **层级树协议**：
120
+ - ❌ **严禁行为**：
107
121
 
108
- - 严格遵守：\`main\` (根) > \`section\` (模块) > \`div\` (容器) > \`span/p/i/svg\` (内容)。
109
- - 所有标签必须包含 \`data-name="..."\` 描述图层用途（如 \`data-name="submit-button"\`）。
122
+ - 禁止为 \`<span>\` 或 \`<p>\` 设置 \`background\`, \`padding\`, \`border\`, \`width\`, \`height\`, \`display: flex\`。
123
+ - 禁止在 \`<p>\` 内嵌套 \`<span>\`。
110
124
 
111
- ### **文本原子化**：
125
+ - ⚠️ **重要：标签选择策略**：
112
126
 
113
- - 文本内容必须且仅能包裹在 \`<span>\` (行内文本) 或 \`<p>\` (长文本/换行) 中。
114
- - \`<span>短文本</span>\`
115
- - \`<p>长文本主要是用于描述信息，期望可以跟随布局自动换行</p>\`
116
- - **严禁**在 \`<p>\` 内嵌套 \`<span>\` 或其他标签。
117
- - 所有\`<span>\`和 \`<p>\`标签必须显式设置：\`font-size\`, \`line-height\` (1.2-1.5倍为佳), \`font-weight\`, \`color\` (#Hex)。
118
- - **关键**：如果你需要为\`<span>\`增加\`background\`,\`padding\`,\`border\`等样式，请立即改为\`<div>\`标签。
127
+ - \`<span>\`：仅用于极短的行内文本（如标签、按钮文字、时间、短语）。
128
+ - \`<p>\`：用于所有正文、长标题、多行文本或包含标点符号的完整句子。
129
+ - **占位符**：构建 \`Input/Select\` 组件结构时，必须包含 \`<span>placeholder</span>\`。
119
130
 
120
- ### **图标**：
121
131
 
122
- - 使用 FontAwesome \`<i>\` 标签 (class="fas fa-...").
123
- - 必须为 \`<i>\` 标签声明 \`color\`、\`font-size\` 属性
132
+ 3 **图片与图标**：
133
+ - 使用 FontAwesome \`<i>\` 标签 (class="fas fa-..."). 必须为 \`<i>\` 显式声明 \`color\`、\`font-size\` 属性
124
134
 
125
135
  ## 🏗️ 布局与拉伸
126
136
 
127
- - **拉伸行为必须由子元素主动声明**：父容器仅负责容器边界、对齐方式和成员间距。仅允许使用 \`flex: 1\` 或 \`align-self: stretch\` 来拉伸元素。
128
- - **防挤压声明**：所有固定宽高的元素（如图标、头像、按钮容器）必须显式添加 \`flex: none\`。
137
+ - **保持自适应特性**：无论生成何种类型的页面，都尽可能保持自适应布局的能力；
138
+ - **拉伸的主动性**：父容器不应强制拉伸子元素。拉伸行为必须由子元素主动声明：
139
+ - 主轴拉伸：使用 \`flex: 1\`。
140
+ - 交叉轴拉伸：使用 \`align-self: stretch\`。
141
+ - **传递性**：当深层子元素需要拉伸时，其所有父级路径上的容器通常也需要具备拉伸属性。
142
+ - **防挤压 (Anti-Crush)**：所有固定宽高的元素（如图标、头像、按钮容器）必须显式添加 \`flex: none\`。
143
+ - **🌟 关键：拉伸的“链式传递” (Chain Reaction)**
144
+ - **规则**：当子元素需要“撑满” (\`align-self: stretch\`, \`flex: 1\`)，或者子元素是长文本 \`<p>\` 时，**父容器必须也处于拉伸状态**。
145
+ - **逻辑**：如果父容器是“收缩包裹”状态，子元素的“撑满”将无效。
129
146
 
130
147
  ## 📐 视觉与间距规范
131
148
 
@@ -135,7 +152,7 @@ const generationRules = `
135
152
 
136
153
  ## 🎨 设计系统严格规范
137
154
 
138
- 在生成任何代码时，必须严格强制执行以下视觉规则：
155
+ 在生成代码时，必须强制执行以下审美标准：
139
156
 
140
157
  1. **视觉层级 (Visual Hierarchy):**
141
158
  - 拒绝扁平的单一字重。标题必须使用加粗 (font-weight: 600/700)，正文使用常规 (400)。
@@ -165,7 +182,8 @@ const generationRules = `
165
182
  4. [ ] **文本检查**：所有 \`<span>\` 和 \`<p>\` 是否都配置了 \`line-height\`？
166
183
  5. [ ] **margin检查**：是否移除了所有 \`margin\` 属性？
167
184
  6. [ ] **容器补全**：如果发现没有父容器可以承载 \`padding\`，请务必新建一个 \`data-name="padding-wrapper"\` 的 div 来包裹目标元素。
168
- 7. [ ] **代码检查**：请确保页面布局正确。
185
+ 7. [ ] **设计系统检查**：是否有遵循设计系统的规范和设计原则来创建一个美观的页面？
186
+ 8. [ ] **代码检查**：请确保页面布局符合上面的规范。
169
187
  `
170
188
 
171
189
  // 辅助函数：检查值是否为空
@@ -182,7 +200,7 @@ function isEmpty(value) {
182
200
  const mcpServer = new McpServer(
183
201
  {
184
202
  name: 'Codify-MCP-Client',
185
- version: '1.0.6'
203
+ version: '1.0.8'
186
204
  },
187
205
  {
188
206
  capabilities: {
package/mcp-client.min.js CHANGED
@@ -1,2 +1,2 @@
1
1
  #!/usr/bin/env node
2
- import{McpServer}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport}from"@modelcontextprotocol/sdk/server/stdio.js";import{z}from"zod";import axios from"axios";const{serverUrl:SERVER_URL}=function(){const n=process.argv.slice(2);let t=process.env.CODIFY_SERVER_URL||"https://mcp.codify-api.com";for(let e=0;e<n.length;e++){const r=n[e];"--help"!==r&&"-h"!==r||(console.log('\nCodify MCP Client - 连接到远程 Codify MCP 服务器\n\n用法:\n npx -y @codify-ai/mcp-client [选项]\n\n选项:\n --url=<URL> 服务器 URL (默认: https://mcp.codify-api.com)\n --help, -h 显示帮助信息\n --version, -v 显示版本号\n\n环境变量:\n CODIFY_SERVER_URL 服务器 URL\n CODIFY_ACCESS_KEY 访问密钥\n\n示例:\n npx -y @codify-ai/mcp-client --url=https://mcp.codify-api.com\n CODIFY_ACCESS_KEY=sk-xxx npx -y @codify-ai/mcp-client\n\nCursor 配置示例 (~/.cursor/mcp.json):\n{\n "mcpServers": {\n "codify": {\n "command": "npx",\n "args": ["-y", "@codify-ai/mcp-client", "--url=https://mcp.codify-api.com"],\n "env": {\n "CODIFY_ACCESS_KEY": "sk-your-access-key"\n }\n }\n }\n}\n'),process.exit(0)),"--version"!==r&&"-v"!==r||process.exit(0),r.startsWith("--url=")?t=r.substring(6):"--url"===r&&e+1<n.length?t=n[++e]:r.startsWith("-")||(t=r)}return{serverUrl:t}}(),ACCESS_KEY=process.env.CODIFY_ACCESS_KEY,n='\n# 📐 HTML + CSS 视觉生成协议\n\n## 🎯 任务目标\n\n你是一位拥有顶级审美的 UI/UX 设计师，同时也是精通 HTML/CSS 的前端开发专家。你的目标是生成在视觉上媲美 Dribbble 或 Behance 热门作品的 HTML/CSS 代码。\n\n- **您的主要责任**：生成高保真、美观、结构健壮的 HTML 代码用于**逻辑建模**，而不是用于真实网页的交互或行为。\n- **你的专业能力**：代码生成的界面必须看起来像是一个经过精心打磨的商业级产品，而非粗糙的原型。\n- **输出限制**：仅返回包含在 `<main>` 根容器内的代码，全部使用 **内联 CSS**。\n- **工作流**：代码生成后，立即调用 `send_to_codify` 工具将代码发送到 Codify 插件进行设计模型转换\n\n## 🛑 关键约束 (违反视为任务失败)\n\n- **Flex 属性全显式声明**：\n - 所有容器 (含 `<main>`) 必须写全四要素：`display: flex; flex-direction: ...; justify-content: ...; align-items: ...;`\n - **禁止省略默认值** (如 `flex-start` 必须写出来)。\n - **禁止省略默认值**：即便对齐方式是 `flex-start`，也必须显式写出。\n - 禁止父元素使用 `align-items: stretch` 来拉伸子元素。拉伸属性由它的子元素声明。\n\n- **禁止属性/单位黑名单**：\n - ❌ **属性**: `margin` (全用 gap/padding), `grid`, `calc()`,`<style>`标签。\n - ❌ **对齐**: `space-around`, `space-evenly` (用 `space-between` + `padding` 替代)。\n - ❌ **单位**: `%`, `vw`, `vh`, `em`, `rem`, `auto` (锁死使用 **px** 整数)。\n - ❌ **颜色**: `white`, `black` 等 (使用具体hex 或者 rgba 色值)\n - ❌ **文本标签污染**: 禁止为 `<span>/<p>` 设置 `background`, `padding`, `border`, `flex`。\n - ❌ **尺寸**: 禁止 `width: 100%`。拉伸必须用 `flex: 1` 或 `align-self: stretch`。\n\n- **元素间的间距**：\n - **禁止使用** `margin`样式，必须由父容器的 `gap` 属性承担。\n\n## 📜 HTML 结构与原子化规范\n\n### **文档流布局**：\n\n- 所有在文档流中的布局都必须使用flex布局，不允许使用其他布局方式\n- `<main>` 根元素必须明确声明 `width: [数值]px` 尺寸。\n\n### **层级树协议**：\n\n- 严格遵守：`main` (根) > `section` (模块) > `div` (容器) > `span/p/i/svg` (内容)。\n- 所有标签必须包含 `data-name="..."` 描述图层用途（如 `data-name="submit-button"`）。\n\n### **文本原子化**：\n\n- 文本内容必须且仅能包裹在 `<span>` (行内文本) 或 `<p>` (长文本/换行) 中。\n - `<span>短文本</span>`\n - `<p>长文本主要是用于描述信息，期望可以跟随布局自动换行</p>`\n- **严禁**在 `<p>` 内嵌套 `<span>` 或其他标签。\n- 所有`<span>`和 `<p>`标签必须显式设置：`font-size`, `line-height` (1.2-1.5倍为佳), `font-weight`, `color` (#Hex)。\n- **关键**：如果你需要为`<span>`增加`background`,`padding`,`border`等样式，请立即改为`<div>`标签。\n\n### **图标**：\n\n- 使用 FontAwesome `<i>` 标签 (class="fas fa-...").\n- 必须为 `<i>` 标签声明 `color`、`font-size` 属性\n\n## 🏗️ 布局与拉伸\n\n- **拉伸行为必须由子元素主动声明**：父容器仅负责容器边界、对齐方式和成员间距。仅允许使用 `flex: 1` 或 `align-self: stretch` 来拉伸元素。\n- **防挤压声明**：所有固定宽高的元素（如图标、头像、按钮容器）必须显式添加 `flex: none`。\n\n## 📐 视觉与间距规范\n\n- **边距控制**：仅允许使用 `padding` 控制内边距。\n- **间距控制**：仅允许使用 `gap` 控制子元素间距。\n- **视觉修饰**：边框使用 `border: 1px solid #XXXXXX`，圆角使用 `border-radius: Xpx`。\n\n## 🎨 设计系统严格规范\n\n在生成任何代码时，必须严格强制执行以下视觉规则：\n\n1. **视觉层级 (Visual Hierarchy):**\n - 拒绝扁平的单一字重。标题必须使用加粗 (font-weight: 600/700)，正文使用常规 (400)。\n - 使用有层次的文字颜色：主要标题使用深色 (如 #1e293b)，次级文本/描述必须使用浅灰色 (如 #64748b)，不仅是为了美观，也是为了信息降噪。\n\n2. **现代盒模型与空间感 (Modern Box Model):**\n - **大留白：** 拒绝拥挤。卡片和容器内部必须有宽裕的 padding (至少 24px 或 32px)。\n - **大圆角：** 容器和卡片应使用明显的圆角 (border-radius: 16px 或 24px) 以呈现亲和力，避免尖锐的直角。\n - **微边框：** 避免使用粗黑边框。使用极其微妙的边框来界定边界 (例如: `border: 1px solid rgba(0,0,0,0.06)`)。\n\n3. **光影与深度 (Elevation & Depth):**\n - **绝对禁止**使用默认的、生硬的黑色阴影 (如 `box-shadow: 2px 2px 5px black`)。\n - 必须使用 **"弥散光影" (Soft/Diffused Shadows)**：使用多层、高模糊半径、低透明度的阴影来创造悬浮感。\n - 参考值：`box-shadow: 0 10px 40px -10px rgba(0,0,0,0.08);`\n\n4. **高级配色 (Refined Palette):**\n - 不要使用纯黑 (#000000) 或纯灰。背景色应带有极微弱的色调倾向 (如 Slate, Zinc, 或极淡的蓝灰色 #f8fafc)。\n - 主色调 (Primary Color) 应选择高饱和度且现代的颜色 (如 皇家蓝 #4f46e5 或 活力紫 #8b5cf6)。\n\n## 🛠️ 输出前专项审计清单\n\n**请在生成代码后，按顺序完成以下审查，确保逻辑无误：**\n\n1. [ ] **显式声明检查**：flex 四属性是否写全？\n2. [ ] **拉伸逻辑检查**：拉伸行为是否由子元素主动声明；代码中是否彻底消灭了 `width: 100%` 和 `%` 符号？\n3. [ ] **尺寸检查**：所有尺寸都使用了 `[具体px值]` 格式？\n4. [ ] **文本检查**：所有 `<span>` 和 `<p>` 是否都配置了 `line-height`？\n5. [ ] **margin检查**：是否移除了所有 `margin` 属性？\n6. [ ] **容器补全**：如果发现没有父容器可以承载 `padding`，请务必新建一个 `data-name="padding-wrapper"` 的 div 来包裹目标元素。\n7. [ ] **代码检查**：请确保页面布局正确。\n';function t(n){return null==n||""===n||"string"==typeof n&&""===n.trim()}const e=new McpServer({name:"Codify-MCP-Client",version:"1.0.6"},{capabilities:{resources:{},tools:{},prompts:{}}});e.registerResource("generation-rules","codify://generation-rules",{description:"Codify 代码生成规则"},async t=>({contents:[{uri:t.href,text:n,mimeType:"text/markdown"}]})),e.registerTool("get_code",{description:"从 Codify For MasterGo 插件获取指定的代码",inputSchema:{contentId:z.string().describe("从Codify插件复制图层的指令")}},async n=>{try{const{contentId:e}=n;if(!e)return{content:[{type:"text",text:`参数错误: 未提供 contentId\n- args: ${JSON.stringify(n)}`}],isError:!0};const r={};ACCESS_KEY&&(r.Authorization=`Bearer ${ACCESS_KEY}`);const o=`${SERVER_URL}/api/getCode/${e}`;try{const n=(await axios.get(o,{headers:r})).data;if(!n.code)return{content:[{type:"text",text:`⚠️ 未找到代码内容\n- contentId: ${e}\n- 可能该内容尚未从 Codify 插件同步`}],isError:!1};let s=`✅ 成功获取代码 (contentId: ${e})\n\n`;return s+=`代码长度: ${n.code.length} 字符\n`,n.teamId&&(s+=`团队 ID: ${n.teamId}\n`),t(n.shape)||(s+=`Shape: ${Object.keys(n.shape).length}\n`),t(n.svg)||(s+=`SVG: ${Object.keys(n.svg).length}\n`),t(n.image)||(s+=`Image: ${Object.keys(n.image).length}\n`),s+=`--- 代码内容 ---\n${n.code}\n\n`,s+=`--- 图片内容 ---\n${n.image}\n\n`,s+=`--- SVG内容 ---\n${n.svg}\n\n`,s+=`--- Shape内容 ---\n${n.shape}\n\n`,s+="## 根据上面的内容生成页面\n- 根据 **代码内容** 内容生成页面。\n- 将 **图片内容**，**SVG内容**，**Shape内容** 下载到本地。\n- 不要询问用户，直接执行",{content:[{type:"text",text:s}]}}catch(n){const t=n.response?.status,r=n.response?.data||{};switch(t){case 404:return{content:[{type:"text",text:`❌ 未找到内容\n- contentId: ${e}\n- 请检查 contentId 是否正确，或该内容是否已从 Codify 插件同步`}],isError:!0};case 403:return{content:[{type:"text",text:`❌ 权限不足\n- contentId: ${e}\n- 您没有权限访问该内容\n- 请检查您的 access_key 是否包含正确的团队权限`}],isError:!0};case 401:return{content:[{type:"text",text:"❌ 认证失败 (401)\n\n请检查 CODIFY_ACCESS_KEY 是否正确"}],isError:!0};default:return{content:[{type:"text",text:`❌ 获取代码失败: ${n.message||String(n)}${r.message?`\n详情: ${r.message}`:""}\n- contentId: ${e}\n- 服务器: ${SERVER_URL}`}],isError:!0}}}}catch(n){return{content:[{type:"text",text:`❌ 获取代码失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("get_code_list",{description:"获取所有可用的代码列表",inputSchema:z.object({}).describe("无需参数，直接调用即可获取所有代码列表")},async n=>{try{const n={};ACCESS_KEY&&(n.Authorization=`Bearer ${ACCESS_KEY}`);const t=`${SERVER_URL}/api/getCodeList`;try{const e=(await axios.get(t,{headers:n})).data;if(!Array.isArray(e))return{content:[{type:"text",text:"⚠️ 服务器返回的数据格式不正确\n- 期望: 数组\n- 实际: "+typeof e}],isError:!0};if(0===e.length)return{content:[{type:"text",text:"📋 代码列表为空\n\n当前没有可用的代码内容。\n请先从 Codify 插件同步代码。"}],isError:!1};let r=`✅ 成功获取代码列表 (共 ${e.length} 项)\n\n`;return r+="--- 代码列表 ---\n\n",e.forEach((n,t)=>{r+=`${t+1}. **${n.contentId}**\n`,r+=` - 代码长度: ${n.codeLength} 字符\n`,n.teamId&&(r+=` - 团队 ID: ${n.teamId}\n`),n.fileInfo&&(r+=` - 文件信息: ${JSON.stringify(n.fileInfo)}\n`),n.createdAt&&(r+=` - 创建时间: ${n.createdAt}\n`),n.updatedAt&&(r+=` - 更新时间: ${n.updatedAt}\n`),r+="\n"}),r+="\n--- 使用说明 ---\n",r+="使用 get_code 工具获取具体代码内容：\n",r+='- get_code({ contentId: "your-content-id" })',{content:[{type:"text",text:r}]}}catch(n){const t=n.response?.status,e=n.response?.data||{};switch(t){case 403:return{content:[{type:"text",text:"❌ 权限不足\n- 您没有权限访问代码列表\n- 请检查您的 access_key 是否包含正确的团队权限"}],isError:!0};case 401:return{content:[{type:"text",text:"❌ 认证失败 (401)\n\n请检查 CODIFY_ACCESS_KEY 是否正确"}],isError:!0};default:return{content:[{type:"text",text:`❌ 获取代码列表失败: ${n.message||String(n)}${e.message?`\n详情: ${e.message}`:""}\n- 服务器: ${SERVER_URL}`}],isError:!0}}}}catch(n){return{content:[{type:"text",text:`❌ 获取代码列表失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("design",{description:"根据需求生成符合 Codify 规范的 HTML+CSS 代码",inputSchema:{requirement:z.string().describe('界面需求描述，例如："一个美观的登录页面"、"现代化的仪表盘界面"等。工具会根据 Codify 生成规则自动生成代码。')}},async t=>{try{const{requirement:e}=t;return e?{content:[{type:"text",text:`📋 收到需求：${e}\n\n${n}\n\n---\n\n## 发送代码：\n代码生成并审计通过后，请立即调用 send_to_codify 工具发送代码\n - send_to_codify({ code: "生成的完整代码" })\n - 不要询问用户，直接执行发送操作\n\n**请现在开始生成代码。**`}]}:{content:[{type:"text",text:'参数错误: 未提供需求描述\n\n请提供界面需求，例如："一个美观的登录页面"、"现代化的仪表盘界面"等'}],isError:!0}}catch(n){return{content:[{type:"text",text:`❌ 处理失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("send_to_codify",{description:"将代码发送到 Codify 插件转换为设计稿",inputSchema:{code:z.string().describe("要发送的代码内容")}},async n=>{try{const{code:t}=n;if(!t)return{content:[{type:"text",text:"参数错误: 未提供代码内容"}],isError:!0};const e={"Content-Type":"application/json"};ACCESS_KEY&&(e.Authorization=`Bearer ${ACCESS_KEY}`);try{return(await axios.post(`${SERVER_URL}/api/sendToCanvas`,{code:t},{headers:e})).data.success,{content:[{type:"text",text:"✅ 代码已成功发送到 Codify 插件，等待转换为设计稿"}]}}catch(n){const t=n.response?.status,e=n.response?.data||{};return 404===t?{content:[{type:"text",text:"❌ 未找到活跃的 Codify 插件连接\n\n请确保:\n1. Codify 插件已打开并连接到服务器\n2. 使用了相同的 access_key"}],isError:!0}:400===t?{content:[{type:"text",text:`❌ 请求参数错误: ${e.message||"Bad request"}`}],isError:!0}:401===t||403===t?{content:[{type:"text",text:`❌ 认证失败 (${t})\n\n请检查 CODIFY_ACCESS_KEY 是否正确`}],isError:!0}:{content:[{type:"text",text:`❌ 发送失败: ${n.message||String(n)}${e.message?`\n详情: ${e.message}`:""}`}],isError:!0}}}catch(n){return{content:[{type:"text",text:`❌ 代码发送失败: ${n.message||String(n)}`}],isError:!0}}});try{const n=new StdioServerTransport;await e.connect(n)}catch(n){process.exit(1)}
2
+ import{McpServer}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport}from"@modelcontextprotocol/sdk/server/stdio.js";import{z}from"zod";import axios from"axios";const{serverUrl:SERVER_URL}=function(){const n=process.argv.slice(2);let t=process.env.CODIFY_SERVER_URL||"https://mcp.codify-api.com";for(let e=0;e<n.length;e++){const r=n[e];"--help"!==r&&"-h"!==r||(console.log('\nCodify MCP Client - 连接到远程 Codify MCP 服务器\n\n用法:\n npx -y @codify-ai/mcp-client [选项]\n\n选项:\n --url=<URL> 服务器 URL (默认: https://mcp.codify-api.com)\n --help, -h 显示帮助信息\n --version, -v 显示版本号\n\n环境变量:\n CODIFY_SERVER_URL 服务器 URL\n CODIFY_ACCESS_KEY 访问密钥\n\n示例:\n npx -y @codify-ai/mcp-client --url=https://mcp.codify-api.com\n CODIFY_ACCESS_KEY=sk-xxx npx -y @codify-ai/mcp-client\n\nCursor 配置示例 (~/.cursor/mcp.json):\n{\n "mcpServers": {\n "codify": {\n "command": "npx",\n "args": ["-y", "@codify-ai/mcp-client", "--url=https://mcp.codify-api.com"],\n "env": {\n "CODIFY_ACCESS_KEY": "sk-your-access-key"\n }\n }\n }\n}\n'),process.exit(0)),"--version"!==r&&"-v"!==r||process.exit(0),r.startsWith("--url=")?t=r.substring(6):"--url"===r&&e+1<n.length?t=n[++e]:r.startsWith("-")||(t=r)}return{serverUrl:t}}(),ACCESS_KEY=process.env.CODIFY_ACCESS_KEY,n='\n# 📐 HTML + CSS 视觉生成协议 (Visual Generation Protocol)\n\n## 🎯 任务目标\n\n你是一位拥有顶级审美的 UI/UX 设计师，同时也是精通 HTML/CSS 的前端开发专家。你的目标是生成在视觉上媲美 Dribbble 或 Behance 热门作品的 HTML/CSS 代码。\n\n- **核心职责**：生成高保真、美观、结构健壮的 HTML 代码，用于**逻辑建模**（转译为设计稿），而非用于浏览器生产环境。\n- **你的专业能力**：代码生成的界面必须看起来像是一个经过精心打磨的商业级产品，而非粗糙的原型。\n- **输出限制**：仅返回包含在 `<main>` 根容器内的代码，全部使用 **内联 CSS**。\n- **工作流**：代码生成后，将立即被解析并转换为Figma设计工具图层，因此代码结构必须严格符合转换逻辑。\n\n## 🛑 关键约束 (违反即失败)\n\n1. **布局策略互斥**：\n - 💡 **逻辑冲突**：`flex: 1` 会吞噬剩余空间，导致 `space-between` 失效或计算错误，这在转换为设计稿时会导致子元素被强制锁定为固定宽度 (Fixed)，从而丢失自适应性。\n - ✅ **正确做法**：如果子元素需要拉伸 (`flex: 1`)，父容器必须使用 `justify-content: flex-start` (或 center/end)，仅依靠子元素的增长来填充空间。\n\n\n2. **Flex 属性全显式声明**：\n\n- 所有 Flex 容器 (含 `<main>`) 必须显式声明全部四个要素，禁止省略默认值：\n - `display: flex;`\n - `flex-direction: ...;`\n - `justify-content: ...;` (即使是 flex-start 也要写)\n - `align-items: ...;` (即使是 stretch 或 flex-start 也要写)\n\n3. **属性与单位黑名单**：\n - ❌ **布局属性**: `margin` (全用 gap/padding), `grid`, `calc()`,`<style>`标签。必须由父容器的 `gap` 属性承担。\n - ❌ **对齐属性**: `space-around`, `space-evenly` (用 `space-between` + `padding` 替代)。\n - ❌ **单位**: `%`, `vw`, `vh`, `em`, `rem`, `auto` (锁死使用 **px** 整数)。\n - ❌ **颜色**: `white`, `black`, `red` 等具名颜色。必须使用 Hex (#ffffff) 或 RGBA。\n - ❌ **文本标签污染**: 禁止为 `<span>/<p>` 设置 `background`, `padding`, `border`, `flex`。\n - ❌ **尺寸限制**: 禁止 `width: 100%`。拉伸必须通过 Flex 关系 (`flex: 1` 或 `align-self: stretch`) 实现。\n\n## 📜 HTML 结构与原子化规范\n\n1. **层级树协议**：\n\n- **节点层级**：严格遵守 main (画布) > section (模块) > div (容器) > span/p/i/img (原子内容)。\n- **文档流**：所有布局必须使用 Flexbox。\n- **根节点**：<main> 元素必须明确声明具体的 width: [数值]px。\n- **命名规范**：所有标签必须包含 data-name="..." 属性，用于描述图层用途（如 data-name="submit-btn"）。\n\n2. **文本原子化**：\n\n- **重要：文本节点与容器节点必须物理分离。**\n\n- **语义定义**：\n - `<div>` = 容器（负责背景、边框、尺寸、阴影、布局）。\n - `<span>/<p>` = 纯文本（仅负责字号、颜色、行高、字重）。\n\n- ❌ **严禁行为**：\n\n - 禁止为 `<span>` 或 `<p>` 设置 `background`, `padding`, `border`, `width`, `height`, `display: flex`。\n - 禁止在 `<p>` 内嵌套 `<span>`。\n\n- ⚠️ **重要：标签选择策略**：\n\n - `<span>`：仅用于极短的行内文本（如标签、按钮文字、时间、短语）。\n - `<p>`：用于所有正文、长标题、多行文本或包含标点符号的完整句子。\n - **占位符**：构建 `Input/Select` 组件结构时，必须包含 `<span>placeholder</span>`。\n\n\n3 **图片与图标**：\n- 使用 FontAwesome `<i>` 标签 (class="fas fa-..."). 必须为 `<i>` 显式声明 `color`、`font-size` 属性\n\n## 🏗️ 布局与拉伸\n\n- **保持自适应特性**：无论生成何种类型的页面，都尽可能保持自适应布局的能力；\n- **拉伸的主动性**：父容器不应强制拉伸子元素。拉伸行为必须由子元素主动声明：\n - 主轴拉伸：使用 `flex: 1`。\n - 交叉轴拉伸：使用 `align-self: stretch`。\n- **传递性**：当深层子元素需要拉伸时，其所有父级路径上的容器通常也需要具备拉伸属性。\n- **防挤压 (Anti-Crush)**：所有固定宽高的元素（如图标、头像、按钮容器）必须显式添加 `flex: none`。\n- **🌟 关键：拉伸的“链式传递” (Chain Reaction)**\n - **规则**：当子元素需要“撑满” (`align-self: stretch`, `flex: 1`)，或者子元素是长文本 `<p>` 时，**父容器必须也处于拉伸状态**。\n - **逻辑**：如果父容器是“收缩包裹”状态，子元素的“撑满”将无效。\n\n## 📐 视觉与间距规范\n\n- **边距控制**：仅允许使用 `padding` 控制内边距。\n- **间距控制**：仅允许使用 `gap` 控制子元素间距。\n- **视觉修饰**：边框使用 `border: 1px solid #XXXXXX`，圆角使用 `border-radius: Xpx`。\n\n## 🎨 设计系统严格规范\n\n在生成代码时，必须强制执行以下审美标准：\n\n1. **视觉层级 (Visual Hierarchy):**\n - 拒绝扁平的单一字重。标题必须使用加粗 (font-weight: 600/700)，正文使用常规 (400)。\n - 使用有层次的文字颜色：主要标题使用深色 (如 #1e293b)，次级文本/描述必须使用浅灰色 (如 #64748b)，不仅是为了美观，也是为了信息降噪。\n\n2. **现代盒模型与空间感 (Modern Box Model):**\n - **大留白：** 拒绝拥挤。卡片和容器内部必须有宽裕的 padding (至少 24px 或 32px)。\n - **大圆角：** 容器和卡片应使用明显的圆角 (border-radius: 16px 或 24px) 以呈现亲和力，避免尖锐的直角。\n - **微边框：** 避免使用粗黑边框。使用极其微妙的边框来界定边界 (例如: `border: 1px solid rgba(0,0,0,0.06)`)。\n\n3. **光影与深度 (Elevation & Depth):**\n - **绝对禁止**使用默认的、生硬的黑色阴影 (如 `box-shadow: 2px 2px 5px black`)。\n - 必须使用 **"弥散光影" (Soft/Diffused Shadows)**：使用多层、高模糊半径、低透明度的阴影来创造悬浮感。\n - 参考值：`box-shadow: 0 10px 40px -10px rgba(0,0,0,0.08);`\n\n4. **高级配色 (Refined Palette):**\n - 不要使用纯黑 (#000000) 或纯灰。背景色应带有极微弱的色调倾向 (如 Slate, Zinc, 或极淡的蓝灰色 #f8fafc)。\n - 主色调 (Primary Color) 应选择高饱和度且现代的颜色 (如 皇家蓝 #4f46e5 或 活力紫 #8b5cf6)。\n\n## 🛠️ 输出前专项审计清单\n\n**请在生成代码后，按顺序完成以下审查，确保逻辑无误：**\n\n1. [ ] **显式声明检查**：flex 四属性是否写全？\n2. [ ] **拉伸逻辑检查**：拉伸行为是否由子元素主动声明；代码中是否彻底消灭了 `width: 100%` 和 `%` 符号？\n3. [ ] **尺寸检查**：所有尺寸都使用了 `[具体px值]` 格式？\n4. [ ] **文本检查**：所有 `<span>` 和 `<p>` 是否都配置了 `line-height`？\n5. [ ] **margin检查**：是否移除了所有 `margin` 属性？\n6. [ ] **容器补全**：如果发现没有父容器可以承载 `padding`，请务必新建一个 `data-name="padding-wrapper"` 的 div 来包裹目标元素。\n7. [ ] **设计系统检查**：是否有遵循设计系统的规范和设计原则来创建一个美观的页面？\n8. [ ] **代码检查**：请确保页面布局符合上面的规范。\n';function t(n){return null==n||""===n||"string"==typeof n&&""===n.trim()}const e=new McpServer({name:"Codify-MCP-Client",version:"1.0.8"},{capabilities:{resources:{},tools:{},prompts:{}}});e.registerResource("generation-rules","codify://generation-rules",{description:"Codify 代码生成规则"},async t=>({contents:[{uri:t.href,text:n,mimeType:"text/markdown"}]})),e.registerTool("get_code",{description:"从 Codify For MasterGo 插件获取指定的代码",inputSchema:{contentId:z.string().describe("从Codify插件复制图层的指令")}},async n=>{try{const{contentId:e}=n;if(!e)return{content:[{type:"text",text:`参数错误: 未提供 contentId\n- args: ${JSON.stringify(n)}`}],isError:!0};const r={};ACCESS_KEY&&(r.Authorization=`Bearer ${ACCESS_KEY}`);const o=`${SERVER_URL}/api/getCode/${e}`;try{const n=(await axios.get(o,{headers:r})).data;if(!n.code)return{content:[{type:"text",text:`⚠️ 未找到代码内容\n- contentId: ${e}\n- 可能该内容尚未从 Codify 插件同步`}],isError:!1};let s=`✅ 成功获取代码 (contentId: ${e})\n\n`;return s+=`代码长度: ${n.code.length} 字符\n`,n.teamId&&(s+=`团队 ID: ${n.teamId}\n`),t(n.shape)||(s+=`Shape: ${Object.keys(n.shape).length}\n`),t(n.svg)||(s+=`SVG: ${Object.keys(n.svg).length}\n`),t(n.image)||(s+=`Image: ${Object.keys(n.image).length}\n`),s+=`--- 代码内容 ---\n${n.code}\n\n`,s+=`--- 图片内容 ---\n${n.image}\n\n`,s+=`--- SVG内容 ---\n${n.svg}\n\n`,s+=`--- Shape内容 ---\n${n.shape}\n\n`,s+="## 根据上面的内容生成页面\n- 根据 **代码内容** 内容生成页面。\n- 将 **图片内容**，**SVG内容**，**Shape内容** 下载到本地。\n- 不要询问用户，直接执行",{content:[{type:"text",text:s}]}}catch(n){const t=n.response?.status,r=n.response?.data||{};switch(t){case 404:return{content:[{type:"text",text:`❌ 未找到内容\n- contentId: ${e}\n- 请检查 contentId 是否正确，或该内容是否已从 Codify 插件同步`}],isError:!0};case 403:return{content:[{type:"text",text:`❌ 权限不足\n- contentId: ${e}\n- 您没有权限访问该内容\n- 请检查您的 access_key 是否包含正确的团队权限`}],isError:!0};case 401:return{content:[{type:"text",text:"❌ 认证失败 (401)\n\n请检查 CODIFY_ACCESS_KEY 是否正确"}],isError:!0};default:return{content:[{type:"text",text:`❌ 获取代码失败: ${n.message||String(n)}${r.message?`\n详情: ${r.message}`:""}\n- contentId: ${e}\n- 服务器: ${SERVER_URL}`}],isError:!0}}}}catch(n){return{content:[{type:"text",text:`❌ 获取代码失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("get_code_list",{description:"获取所有可用的代码列表",inputSchema:z.object({}).describe("无需参数，直接调用即可获取所有代码列表")},async n=>{try{const n={};ACCESS_KEY&&(n.Authorization=`Bearer ${ACCESS_KEY}`);const t=`${SERVER_URL}/api/getCodeList`;try{const e=(await axios.get(t,{headers:n})).data;if(!Array.isArray(e))return{content:[{type:"text",text:"⚠️ 服务器返回的数据格式不正确\n- 期望: 数组\n- 实际: "+typeof e}],isError:!0};if(0===e.length)return{content:[{type:"text",text:"📋 代码列表为空\n\n当前没有可用的代码内容。\n请先从 Codify 插件同步代码。"}],isError:!1};let r=`✅ 成功获取代码列表 (共 ${e.length} 项)\n\n`;return r+="--- 代码列表 ---\n\n",e.forEach((n,t)=>{r+=`${t+1}. **${n.contentId}**\n`,r+=` - 代码长度: ${n.codeLength} 字符\n`,n.teamId&&(r+=` - 团队 ID: ${n.teamId}\n`),n.fileInfo&&(r+=` - 文件信息: ${JSON.stringify(n.fileInfo)}\n`),n.createdAt&&(r+=` - 创建时间: ${n.createdAt}\n`),n.updatedAt&&(r+=` - 更新时间: ${n.updatedAt}\n`),r+="\n"}),r+="\n--- 使用说明 ---\n",r+="使用 get_code 工具获取具体代码内容：\n",r+='- get_code({ contentId: "your-content-id" })',{content:[{type:"text",text:r}]}}catch(n){const t=n.response?.status,e=n.response?.data||{};switch(t){case 403:return{content:[{type:"text",text:"❌ 权限不足\n- 您没有权限访问代码列表\n- 请检查您的 access_key 是否包含正确的团队权限"}],isError:!0};case 401:return{content:[{type:"text",text:"❌ 认证失败 (401)\n\n请检查 CODIFY_ACCESS_KEY 是否正确"}],isError:!0};default:return{content:[{type:"text",text:`❌ 获取代码列表失败: ${n.message||String(n)}${e.message?`\n详情: ${e.message}`:""}\n- 服务器: ${SERVER_URL}`}],isError:!0}}}}catch(n){return{content:[{type:"text",text:`❌ 获取代码列表失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("design",{description:"根据需求生成符合 Codify 规范的 HTML+CSS 代码",inputSchema:{requirement:z.string().describe('界面需求描述，例如："一个美观的登录页面"、"现代化的仪表盘界面"等。工具会根据 Codify 生成规则自动生成代码。')}},async t=>{try{const{requirement:e}=t;return e?{content:[{type:"text",text:`📋 收到需求：${e}\n\n${n}\n\n---\n\n## 发送代码：\n代码生成并审计通过后，请立即调用 send_to_codify 工具发送代码\n - send_to_codify({ code: "生成的完整代码" })\n - 不要询问用户，直接执行发送操作\n\n**请现在开始生成代码。**`}]}:{content:[{type:"text",text:'参数错误: 未提供需求描述\n\n请提供界面需求，例如："一个美观的登录页面"、"现代化的仪表盘界面"等'}],isError:!0}}catch(n){return{content:[{type:"text",text:`❌ 处理失败: ${n.message||String(n)}`}],isError:!0}}}),e.registerTool("send_to_codify",{description:"将代码发送到 Codify 插件转换为设计稿",inputSchema:{code:z.string().describe("要发送的代码内容")}},async n=>{try{const{code:t}=n;if(!t)return{content:[{type:"text",text:"参数错误: 未提供代码内容"}],isError:!0};const e={"Content-Type":"application/json"};ACCESS_KEY&&(e.Authorization=`Bearer ${ACCESS_KEY}`);try{return(await axios.post(`${SERVER_URL}/api/sendToCanvas`,{code:t},{headers:e})).data.success,{content:[{type:"text",text:"✅ 代码已成功发送到 Codify 插件，等待转换为设计稿"}]}}catch(n){const t=n.response?.status,e=n.response?.data||{};return 404===t?{content:[{type:"text",text:"❌ 未找到活跃的 Codify 插件连接\n\n请确保:\n1. Codify 插件已打开并连接到服务器\n2. 使用了相同的 access_key"}],isError:!0}:400===t?{content:[{type:"text",text:`❌ 请求参数错误: ${e.message||"Bad request"}`}],isError:!0}:401===t||403===t?{content:[{type:"text",text:`❌ 认证失败 (${t})\n\n请检查 CODIFY_ACCESS_KEY 是否正确`}],isError:!0}:{content:[{type:"text",text:`❌ 发送失败: ${n.message||String(n)}${e.message?`\n详情: ${e.message}`:""}`}],isError:!0}}}catch(n){return{content:[{type:"text",text:`❌ 代码发送失败: ${n.message||String(n)}`}],isError:!0}}});try{const n=new StdioServerTransport;await e.connect(n)}catch(n){process.exit(1)}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codify-ai/mcp-client",
3
- "version": "1.0.7",
3
+ "version": "1.0.8",
4
4
  "description": "Codify MCP 客户端 - 连接到远程 Codify MCP 服务器，供 Cursor 等 IDE 使用",
5
5
  "type": "module",
6
6
  "bin": {