cloudcc-cli 2.2.3 → 2.2.4

package/src/mcp/tools/Component List Retriever/handler.js

@@ -0,0 +1,43 @@
+/**
+ * Component List Retriever 工具处理器
+ * 提供自定义组件列表查询功能
+ */
+
+const getPluginModule = require('../../../plugin/get');
+
+/**
+ * 获取自定义组件列表
+ */
+async function listCustomComponents({ projectPath = process.cwd() }) {
+    try {
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            const componentList = await getPluginModule(['get', projectPath]);
+
+            if (!componentList || componentList.length === 0) {
+                return {
+                    content: [{
+                        type: 'text',
+                        text: '未找到任何自定义组件\n\n提示：使用 create_plugin 创建新组件'
+                    }]
+                };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(componentList, null, 2) }] };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 查询失败: ${error.message}\n\n可能的原因:\n- 项目路径不正确\n- 网络连接问题\n- 服务器API不可用`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    listCustomComponents
+};

package/src/mcp/tools/Component Publisher/handler.js

@@ -0,0 +1,18 @@
+/**
+* 发布插件/自定义组件到服务器
+* 返回命令给智能体执行，而不是在工具中执行
+*/
+async function publishCustomComponent({ componentName, projectPath = process.cwd() }) {
+    const command = `npx cc publish plugin ${componentName}`;
+
+    return {
+        content: [{
+            type: 'text',
+            text: `请执行以下命令发布自定义组件：\n\n\`\`\`bash\n${command}\n\`\`\`\n\n组件名称: ${componentName}\n项目路径: ${projectPath}\n\n执行此命令将：\n1. 编译 Vue 组件\n2. 收集依赖文件\n3. 上传到 CloudCC 服务器`
+        }]
+    };
+}
+
+module.exports = {
+    publishCustomComponent
+};

package/src/mcp/tools/Component Puller/handler.js

@@ -0,0 +1,63 @@
+/**
+ * Component Puller 工具处理器
+ * 从服务器拉取自定义组件到本地
+ * 支持通过组件名或ID拉取
+ */
+
+const pullPluginModule = require('../../../plugin/pull');
+
+/**
+ * 从服务器拉取自定义组件
+ * @param {Object} params - 参数对象
+ * @param {string} params.componentName - 组件名称（可选，如果本地存在会从 config.json 读取 id）
+ * @param {string} params.componentId - 组件ID（可选）
+ * @param {string} params.projectPath - 项目根目录路径
+ */
+async function pullCustomComponent({ componentName, componentId, projectPath = process.cwd() }) {
+    try {
+        // 确定输入：优先使用 componentId，否则使用 componentName
+        const input = componentId || componentName;
+
+        if (!input) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: '✗ 拉取失败: 必须提供组件名称或组件ID'
+                }]
+            };
+        }
+
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            // pull.js 已经支持组件名和ID的自动判断
+            // 如果传入组件名且本地存在 config.json，会自动读取 id
+            // 如果传入 ID，直接通过 ID 拉取
+            await pullPluginModule([null, null, input, projectPath]);
+
+            // 从输入推断组件名（用于显示）
+            const displayName = componentName || input;
+
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 拉取成功！组件已从服务器拉取到本地\n\n本地路径: plugins/${displayName}/`
+                }]
+            };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 拉取失败: ${error.message}`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    pullCustomComponent
+};

package/src/mcp/tools/{dev-env/fetcher.js → Dev Environment Creator/fetcher.js }

@@ -19,7 +19,7 @@ const path = require('path');
 
 // ======================== 配置 ========================
 const CONFIG = {
-  SOURCE_URL: 'https://dev-help.cloudcc.cn/devlearn01/huan-jing-da-jian/',
+  SOURCE_URL: 'https://help.cloudcc.cn/devlearn01/huan-jing-da-jian/',
   OUTPUT_FILE: path.join(__dirname, './prompt.js'),
   TIMEOUT: 10000,
   MAX_RETRIES: 3,
@@ -38,11 +38,11 @@ function escapeHtml(text) {
 
 // ======================== 日志工具 ========================
 const logger = {
-  log: (msg) => console.log(`ℹ️  ${msg}`),
-  success: (msg) => console.log(`✅ ${msg}`),
+  log: (msg) => console.error(`ℹ️  ${msg}`),
+  success: (msg) => console.error(`✅ ${msg}`),
   error: (msg) => console.error(`❌ ${msg}`),
   warn: (msg) => console.warn(`⚠️  ${msg}`),
-  info: (msg) => console.log(`📝 ${msg}`),
+  info: (msg) => console.error(`📝 ${msg}`),
 };
 
 // ======================== HTTP 请求 ========================
@@ -483,10 +483,10 @@ async function main() {
     const totalReferences = steps.reduce((sum, s) => sum + s.references.length, 0);
 
     logger.log('📊 爬取统计:');
-    console.log(`   - 步骤数: ${steps.length}`);
-    console.log(`   - 命令数: ${totalCommands}`);
-    console.log(`   - 参考链接: ${totalReferences}`);
-    console.log(`   - 文件大小: ${(jsCode.length / 1024).toFixed(2)} KB`);
+    console.error(`   - 步骤数: ${steps.length}`);
+    console.error(`   - 命令数: ${totalCommands}`);
+    console.error(`   - 参考链接: ${totalReferences}`);
+    console.error(`   - 文件大小: ${(jsCode.length / 1024).toFixed(2)} KB`);
 
     logger.success('✨ 爬取完成！');
 

package/src/mcp/tools/{dev-env/prompt.js → Dev Environment Creator/prompt.js }

@@ -3,13 +3,13 @@
  * 
  * 自动生成的文件，请勿手动修改
  * 生成时间: 2025-12-04T11:10:21.433Z
- * 来源: https://dev-help.cloudcc.cn/devlearn01/huan-jing-da-jian/
+ * 来源: https://help.cloudcc.cn/devlearn01/huan-jing-da-jian/
  */
 
 const metadata = {
   "title": "CloudCC 开发环境搭建指南",
   "description": "详细的开发环境配置教程，涵盖 Node.js、npm、VS Code 等必要工具的安装与配置",
-  "sourceUrl": "https://dev-help.cloudcc.cn/devlearn01/huan-jing-da-jian/",
+  "sourceUrl": "https://help.cloudcc.cn/devlearn01/huan-jing-da-jian/",
   "generatedAt": "2025-12-04T11:10:21.433Z",
   "version": "1.0.0"
 };
@@ -172,6 +172,23 @@ const steps = [
     "difficulty": "medium",
     "estimatedTime": 5
   }
+  ,
+  {
+    "number": 7,
+    "title": "配置开发者密钥",
+    "description": "环境搭建完成后，需要配置开发者密钥以便进行 API 调用和插件开发。可调用MCP工具 `get_developer_key_setup_guide` 获取详细的密钥配置步骤。",
+    "content": "<p>环境搭建完成后，下一步是配置开发者密钥（Developer Key）。建议调用工具 <code>get_developer_key_setup_guide</code> 来获取交互式的引导和具体命令。</p>\n<pre><code>示例：请运行工具 get_developer_key_setup_guide 来查看并完成密钥配置。</code></pre>",
+    "keywords": [
+      "developer key",
+      "密钥",
+      "key",
+      "开发者密钥"
+    ],
+    "commands": [],
+    "references": [],
+    "difficulty": "easy",
+    "estimatedTime": 5
+  }
 ];
 
 const guide = {

package/src/mcp/tools/Dev Environment Validator/handler.js

@@ -0,0 +1,88 @@
+/**
+ * Dev Environment Validator 工具处理器
+ * 读取同目录下的 prompt.js（知识库），并根据请求参数返回格式化的文本内容
+ */
+
+const prompt = require('./prompt.js');
+const { searchSteps, getCommandsByPlatform, getStep, getAllSteps } = require('./prompt.js');
+
+/**
+ * 获取开发环境验证提示
+ * 支持参数：step, search, difficulty, platform, command
+ * 返回结构与其他 MCP 工具一致：{ content: [{ type: 'text', text: '...' }] }
+ */
+async function getDevEnvSetup(params = {}) {
+  const { step, search, difficulty, platform, command } = params;
+  try {
+    if (search) {
+      const results = searchSteps(search);
+      if (!results || results.length === 0) {
+        return { content: [{ type: 'text', text: `未找到包含 "${search}" 的步骤。` }] };
+      }
+      let content = `# 搜索结果: "${search}"\n\n找到 ${results.length} 个相关步骤\n\n`;
+      results.forEach(s => {
+        content += `## ${s.number}. ${s.title}\n**难度**: ${s.difficulty}\n\n`;
+      });
+      return { content: [{ type: 'text', text: content }] };
+    }
+
+    if (difficulty) {
+      const results = prompt.steps.filter(s => s.difficulty === difficulty);
+      let content = `# ${difficulty} 难度步骤 (共 ${results.length} 个)\n\n`;
+      results.forEach(s => {
+        content += `${s.number}. ${s.title}\n`;
+      });
+      return { content: [{ type: 'text', text: content }] };
+    }
+
+    if (platform) {
+      const commands = getCommandsByPlatform(platform);
+      let content = `# ${platform} 平台命令 (共 ${commands.length} 个)\n\n`;
+      commands.forEach((cmd, idx) => {
+        content += `${idx + 1}. ${cmd.description}\n\n\`\`\`bash\n${cmd.command}\n\`\`\`\n\n`;
+      });
+      return { content: [{ type: 'text', text: content }] };
+    }
+
+    if (step) {
+      const targetStep = getStep(step);
+      if (!targetStep) {
+        return { content: [{ type: 'text', text: `无效的步骤编号 ${step}` }] };
+      }
+      let content = `# 步骤 ${targetStep.number}: ${targetStep.title}\n\n**难度**: ${targetStep.difficulty}\n**耗时**: ${targetStep.estimatedTime} 分钟\n\n${targetStep.description}`;
+      if (targetStep.commands && targetStep.commands.length > 0) {
+        content += `\n\n## 命令 (共 ${targetStep.commands.length} 个)\n\n`;
+        targetStep.commands.forEach((cmd, idx) => {
+          content += `${idx + 1}. ${cmd.description}\n\`\`\`bash\n${cmd.command}\n\`\`\`\n\n`;
+        });
+      }
+      return { content: [{ type: 'text', text: content }] };
+    }
+
+    if (command) {
+      const steps = getAllSteps();
+      let content = `# 所有命令 (共 ${steps.reduce((sum, s) => sum + (s.commands ? s.commands.length : 0), 0)} 个)\n\n`;
+      steps.forEach(s => {
+        if (s.commands && s.commands.length > 0) {
+          content += `## ${s.title}\n`;
+          s.commands.forEach(cmd => {
+            content += `\`\`\`bash\n${cmd.command}\n\`\`\`\n`;
+          });
+          content += `\n`;
+        }
+      });
+      return { content: [{ type: 'text', text: content }] };
+    }
+
+    // 默认概览
+    const allSteps = getAllSteps();
+    let content = `# ${prompt.title}\n\n${prompt.description}\n\n**版本**: ${prompt.version}\n**步骤数**: ${allSteps.length}`;
+    return { content: [{ type: 'text', text: content }] };
+  } catch (error) {
+    return { content: [{ type: 'text', text: `错误: ${error.message}` }] };
+  }
+}
+
+module.exports = {
+  getDevEnvSetup
+};

package/src/mcp/tools/Dev Environment Validator/prompt.js

@@ -0,0 +1,193 @@
+/**
+ * 开发环境验证提示词
+ *
+ * 自动生成的文件，请勿手动修改（可覆盖）
+ * 生成时间: 2025-12-11T00:00:00.000Z
+ */
+
+const metadata = {
+    title: "开发环境检查 - CloudCC",
+    description: "在开始使用 cloudcc-cli 之前的本地开发环境检查提示",
+    generatedAt: "2025-12-11T00:00:00.000Z",
+    version: "1.0.0"
+};
+
+const steps = [
+    {
+        number: 1,
+        title: "安装 Node.js",
+        description: "本地需要安装 Node.js。推荐使用版本 v20.19.5。",
+        content: "<p>请确保本地安装了 Node.js，推荐使用 <strong>v20.19.5</strong> 以保证与项目依赖兼容。</p>\n<pre><code>下载地址: https://nodejs.org/download/release/v20.19.5/\n# 或使用 nvm 安装并切换版本（推荐）\nnvm install 20.19.5\nnvm use 20.19.5</code></pre>",
+        keywords: ["node", "nodejs", "v20.19.5"],
+        commands: [
+            {
+                command: "node -v",
+                platform: "all",
+                description: "检查已安装的 Node.js 版本"
+            }
+        ],
+        difficulty: "easy",
+        estimatedTime: 5
+    },
+    {
+        number: 2,
+        title: "切换 npm 源以加速安装",
+        description: "建议将 npm 源切换为国内镜像以加速依赖安装。",
+        content: "<p>将 npm 源切换到淘宝/npmmirror 镜像可以显著加快包安装速度：</p>\n<pre><code>npm config set registry https://registry.npmmirror.com\n# 验证当前 registry 设置\nnpm config get registry</code></pre>",
+        keywords: ["npm", "registry", "npmmirror"],
+        commands: [
+            {
+                command: "npm config set registry https://registry.npmmirror.com",
+                platform: "all",
+                description: "设置 npm registry 为 npmmirror"
+            },
+            {
+                command: "npm config get registry",
+                platform: "all",
+                description: "验证当前 npm registry"
+            }
+        ],
+        difficulty: "easy",
+        estimatedTime: 2
+    },
+    {
+        number: 3,
+        title: "全局安装 cloudcc-cli 脚手架",
+        description: "安装并验证全局可用的 `cloudcc-cli` 命令。",
+        content: "<p>通过 npm 全局安装 cloudcc-cli，以便在命令行中使用相关脚手架命令：</p>\n<pre><code>npm install -g cloudcc-cli\n# 如遇权限问题（macOS），可使用 sudo 或配置 npm 全局安装路径\nsudo npm install -g cloudcc-cli\n# 验证安装是否成功\ncloudcc --version || cc --version</code></pre>",
+        keywords: ["cloudcc-cli", "global", "npm"],
+        commands: [
+            {
+                command: "npm install -g cloudcc-cli",
+                platform: "all",
+                description: "全局安装 cloudcc-cli"
+            },
+            {
+                command: "npm ls -g --depth=0",
+                platform: "all",
+                description: "查看已安装的全局包，确认 cloudcc-cli 是否存在"
+            }
+        ],
+        difficulty: "easy",
+        estimatedTime: 5
+    }
+    ,
+    {
+        number: 4,
+        title: "检查 Java 开发环境（建议 JDK 17）",
+        description: "如果你的项目或后端组件使用 Java，需要在本机安装并配置 JDK。推荐使用 JDK 17（LTS）以获得最佳兼容性与长期支持。",
+        content: "<p>请检查本地是否安装 Java（JDK），并尽量使用 <strong>JDK 17</strong>。</p>\n<pre><code># 检查 Java 运行时版本\njava -version\n# 检查 Java 编译器版本\njavac -version</code></pre>\n<p>在 macOS 上，推荐通过 Homebrew 或 SDKMAN 安装 JDK 17：</p>\n<pre><code># Homebrew 安装（macOS）\nbrew install openjdk@17\n# 然后按提示将路径加入到环境变量，例如：\n# sudo ln -sfn /usr/local/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk\n# 或者使用 SDKMAN（跨平台）\ncurl -s \"https://get.sdkman.io\" | bash\nsource \"$HOME/.sdkman/bin/sdkman-init.sh\"\nsdk install java 17.0.##-open\n</code></pre>",
+        keywords: ["java", "jdk", "jdk17", "java17"],
+        commands: [
+            {
+                command: "java -version",
+                platform: "all",
+                description: "检查 Java 运行时版本"
+            },
+            {
+                command: "javac -version",
+                platform: "all",
+                description: "检查 Java 编译器版本"
+            },
+            {
+                command: "brew install openjdk@17",
+                platform: "macos",
+                description: "在 macOS 上通过 Homebrew 安装 JDK 17（如已安装 Homebrew）"
+            }
+        ],
+        references: [],
+        difficulty: "medium",
+        estimatedTime: 10
+    },
+    {
+        number: 5,
+        title: "检查 VS Code 及必要扩展",
+        description: "如果安装了 VS Code，需要安装 CloudCC 和 Extension Pack for Java 两个扩展以支持 CloudCC 开发和 Java 开发。",
+        content: "<p>请检查本地是否安装了 <strong>Visual Studio Code</strong>，以及是否已安装以下两个扩展：</p>\n<ul><li><strong>CloudCC</strong> - 用于 CloudCC 平台开发支持</li><li><strong>Extension Pack for Java</strong> - 微软官方 Java 开发工具集，包含 Language Support for Java、Debugger for Java 等</li></ul>\n<p>安装 VS Code 扩展的方式：</p>\n<ol><li>打开 VS Code，点击左侧的<strong>扩展</strong>图标（或按 Ctrl+Shift+X / Cmd+Shift+X）</li><li>在搜索框中分别搜索 \"CloudCC\" 和 \"Extension Pack for Java\"</li><li>点击 \"安装\" 按钮</li></ol>\n<p>或使用命令行安装：</p>\n<pre><code># 安装 CloudCC 扩展\ncode --install-extension cloudcc.cloudcc\n# 安装 Extension Pack for Java\ncode --install-extension vscjava.vscode-java-pack</code></pre>",
+        keywords: ["vscode", "vs code", "extension", "cloudcc", "java"],
+        commands: [
+            {
+                command: "code --version",
+                platform: "all",
+                description: "检查 VS Code 是否已安装"
+            },
+            {
+                command: "code --install-extension cloudcc.cloudcc",
+                platform: "all",
+                description: "安装 CloudCC 扩展"
+            },
+            {
+                command: "code --install-extension vscjava.vscode-java-pack",
+                platform: "all",
+                description: "安装 Extension Pack for Java"
+            }
+        ],
+        references: [],
+        difficulty: "easy",
+        estimatedTime: 5
+    }
+];
+
+const guide = {
+    ...metadata,
+    steps,
+};
+
+/**
+ * 在步骤中按关键词搜索（大小写不敏感）。
+ *
+ * @param {string} keyword - 要搜索的关键词，会被转为小写再匹配。
+ * @returns {Array<Object>} 匹配到的步骤数组，每项为 steps 中的 step 对象。
+ */
+function searchSteps(keyword) {
+    const lower = keyword.toLowerCase();
+    return guide.steps.filter(step =>
+        step.title.toLowerCase().includes(lower) ||
+        step.description.toLowerCase().includes(lower) ||
+        step.keywords.some(k => k.toLowerCase().includes(lower))
+    );
+}
+
+/**
+ * 按平台收集可执行命令列表。
+ *
+ * @param {string} platform - 目标平台标识（例如 'all', 'macos', 'windows' 等）。
+ * @returns {Array<Object>} 命令对象数组，每个对象包含 `command`, `platform`, `description`。
+ */
+function getCommandsByPlatform(platform) {
+    const commands = [];
+    guide.steps.forEach(step => {
+        step.commands.forEach(cmd => {
+            if (cmd.platform === 'all' || cmd.platform === platform) {
+                commands.push(cmd);
+            }
+        });
+    });
+    return commands;
+}
+
+/**
+ * 根据步骤号获取单个步骤详情。
+ *
+ * @param {number} stepNumber - 步骤编号（整数）。
+ * @returns {Object|undefined} 匹配的步骤对象，未找到时返回 undefined。
+ */
+function getStep(stepNumber) {
+    return guide.steps.find(s => s.number === stepNumber);
+}
+
+/**
+ * 获取所有步骤列表。
+ *
+ * @returns {Array<Object>} 当前 guide 中定义的全部步骤数组。
+ */
+function getAllSteps() {
+    return guide.steps;
+}
+
+module.exports = guide;
+module.exports.searchSteps = searchSteps;
+module.exports.getCommandsByPlatform = getCommandsByPlatform;
+module.exports.getStep = getStep;
+module.exports.getAllSteps = getAllSteps;
+

package/src/mcp/tools/{key-guide/fetcher.js → Developer Key Setup Guide/fetcher.js }

@@ -19,7 +19,7 @@ const path = require('path');
 
 // ======================== 配置 ========================
 const CONFIG = {
-  SOURCE_URL: 'https://dev-help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/',
+  SOURCE_URL: 'https://help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/',
   OUTPUT_FILE: path.join(__dirname, './prompt.js'),
   TIMEOUT: 10000,
   MAX_RETRIES: 3,
@@ -38,11 +38,11 @@ function escapeHtml(text) {
 
 // ======================== 日志工具 ========================
 const logger = {
-  log: (msg) => console.log(`ℹ️  ${msg}`),
-  success: (msg) => console.log(`✅ ${msg}`),
+  log: (msg) => console.error(`ℹ️  ${msg}`),
+  success: (msg) => console.error(`✅ ${msg}`),
   error: (msg) => console.error(`❌ ${msg}`),
   warn: (msg) => console.warn(`⚠️  ${msg}`),
-  info: (msg) => console.log(`📝 ${msg}`),
+  info: (msg) => console.error(`📝 ${msg}`),
 };
 
 // ======================== HTTP 请求 ========================
@@ -262,9 +262,9 @@ async function main() {
     const totalContent = guides.reduce((sum, g) => sum + g.content.length, 0);
 
     logger.log('📊 爬取统计:');
-    console.log(`   - 指南数: ${guides.length}`);
-    console.log(`   - 总内容大小: ${(totalContent / 1024).toFixed(2)} KB`);
-    console.log(`   - 文件大小: ${(jsCode.length / 1024).toFixed(2)} KB`);
+    console.error(`   - 指南数: ${guides.length}`);
+    console.error(`   - 总内容大小: ${(totalContent / 1024).toFixed(2)} KB`);
+    console.error(`   - 文件大小: ${(jsCode.length / 1024).toFixed(2)} KB`);
 
     logger.success('✨ 爬取完成！');
 

package/src/mcp/tools/{key-guide/prompt.js → Developer Key Setup Guide/prompt.js }

@@ -3,13 +3,13 @@
  * 
  * 自动生成的文件，请勿手动修改
  * 生成时间: 2025-12-04T12:06:58.620Z
- * 来源: https://dev-help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/
+ * 来源: https://help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/
  */
 
 const metadata = {
   "title": "CloudCC 安全标记知识库",
   "description": "详细的安全标记使用指南，涵盖开发者密钥、安全标记配置等安全相关主题",
-  "sourceUrl": "https://dev-help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/",
+  "sourceUrl": "https://help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/",
   "generatedAt": "2025-12-04T12:06:58.620Z",
   "version": "1.0.0"
 };
@@ -17,7 +17,7 @@ const metadata = {
 const guides = [
   {
     "title": "获取开发者密钥",
-    "description": "获取开发者密钥",
+    "description": "获取开发者密钥，包括：safetyMark，CloudCCDev",
     "content": ""
   },
   {

package/src/mcp/tools/Object Creator/handler.js

@@ -0,0 +1,34 @@
+/**
+ * Custom Object Creator Handler
+ * 提供创建自定义对象的 MCP 工具实现
+ */
+
+const path = require('path');
+
+/**
+ * 创建自定义对象
+ * @param {{label: string, projectPath?: string}} params
+ */
+async function createCustomObject(params = {}) {
+    const { label, projectPath } = params;
+    if (!label) {
+        return { content: [{ type: 'text', text: '✗ 参数缺失: label (对象标签) 必须提供' }] };
+    }
+
+    const targetPath = projectPath || '.';
+    const resolvedPath = path.resolve(targetPath);
+    // 如果 label 包含空格或特殊字符，加双引号保护
+    const safeLabel = /\s/.test(label) ? `"${label}"` : label;
+    const command = `npx cc create object  ${targetPath} ${safeLabel}`;
+
+    return {
+        content: [{
+            type: 'text',
+            text: `✓ 自定义对象创建命令已生成!\n\n对象标签: ${label}\n项目目录(解析后): ${resolvedPath}\n\n请运行以下命令以创建对象:\n\n${command}\n\n创建过程:\n1. 生成对象的 schema 文件\n2. 配置对象权限\n3. 部署到 CloudCC 系统`
+        }]
+    };
+}
+
+module.exports = {
+    createCustomObject
+};

package/src/mcp/tools/Object Fields Creator/handler.js

@@ -0,0 +1,64 @@
+/**
+ * Field Creator Handler
+ * 提供创建对象字段的 MCP 工具实现
+ */
+
+const path = require('path');
+const fieldsCreate = require('../../../fields/create');
+
+/**
+ * 创建对象字段
+ * @param {{
+ *   objid: string,
+ *   fieldType: string,
+ *   nameLabel: string,
+ *   ptext: string,
+ *   lookupObj: string,
+ *   projectPath?: string
+ * }} params
+ */
+async function createObjectField(params = {}) {
+    try {
+        let result = null;
+        const resolvedPath = path.resolve(params.projectPath);
+        let argv = null;
+        if ("Y" == params.fieldType || "MR" == params.fieldType || "M" == params.fieldType) {
+            const { objid, fieldType, nameLabel, lookupObj } = params;
+            argv = [null, null, resolvedPath, fieldType, objid, nameLabel, lookupObj];
+        } else if ("L" == params.fieldType || "Q" == params.fieldType) {
+            const { objid, fieldType, nameLabel, ptext } = params;
+            argv = [null, null, resolvedPath, fieldType, objid, nameLabel, ptext];
+        } else {
+            const { objid, fieldType, nameLabel } = params;
+            argv = [null, null, resolvedPath, fieldType, objid, nameLabel];
+        }
+        result = await fieldsCreate(argv);
+
+        if (result) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 字段创建成功!`
+                }]
+            };
+        } else {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `⚠ 字段创建遇到问题\n\n请检查:\n1. 对象ID是否正确\n2. 字段名称是否符合规范\n3. CloudCC服务器连接是否正常\n4. 项目配置是否正确`
+                }]
+            };
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 字段创建失败: ${error.message}\n\n错误详情:\n${error.stack || '无详细信息'}`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    createObjectField
+};