cloudcc-cli 2.2.2 → 2.2.4

package/src/mcp/tools/Developer Key Setup Guide/fetcher.js

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+
+/**
+ * CloudCC 安全标记知识库爬取脚本
+ * 功能：从官方文档网页爬取安全标记使用指南，生成结构化 JavaScript 知识库
+ * 
+ * 特性：
+ * - 自动网页爬取和 HTML 解析
+ * - 安全标记分类和详细说明
+ * - 错误重试和容错机制
+ * - 元数据管理（版本、更新时间、来源）
+ */
+
+const https = require('https');
+const http = require('http');
+const cheerio = require('cheerio');
+const fs = require('fs').promises;
+const path = require('path');
+
+// ======================== 配置 ========================
+const CONFIG = {
+  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,
+  CACHE_DURATION: 7 * 24 * 60 * 60 * 1000, // 7 天
+};
+
+// HTML 转义工具
+function escapeHtml(text) {
+  return String(text)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;');
+}
+
+// ======================== 日志工具 ========================
+const logger = {
+  log: (msg) => console.error(`ℹ️  ${msg}`),
+  success: (msg) => console.error(`✅ ${msg}`),
+  error: (msg) => console.error(`❌ ${msg}`),
+  warn: (msg) => console.warn(`⚠️  ${msg}`),
+  info: (msg) => console.error(`📝 ${msg}`),
+};
+
+// ======================== HTTP 请求 ========================
+async function fetchPage(url, retries = 0) {
+  return new Promise((resolve, reject) => {
+    try {
+      logger.log(`正在获取 ${url}...`);
+
+      const urlObj = new URL(url);
+      const protocol = urlObj.protocol === 'https:' ? https : http;
+
+      const options = {
+        hostname: urlObj.hostname,
+        port: urlObj.port,
+        path: urlObj.pathname + urlObj.search,
+        method: 'GET',
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Node.js MCP Bot) CloudCC-Key-Guide/1.0',
+        },
+        timeout: CONFIG.TIMEOUT,
+      };
+
+      const req = protocol.request(options, (res) => {
+        // 处理重定向
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          const redirectUrl = new URL(res.headers.location, url).href;
+          logger.info(`重定向到: ${redirectUrl}`);
+          return fetchPage(redirectUrl, retries).then(resolve).catch(reject);
+        }
+
+        if (res.statusCode !== 200) {
+          return reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
+        }
+
+        let html = '';
+        res.setEncoding('utf8');
+        res.on('data', (chunk) => {
+          html += chunk;
+        });
+        res.on('end', () => {
+          logger.success(`网页获取成功 (${html.length} 字节)`);
+          resolve(html);
+        });
+      });
+
+      req.on('error', (error) => {
+        reject(error);
+      });
+
+      req.on('timeout', () => {
+        req.destroy();
+        reject(new Error('请求超时'));
+      });
+
+      req.end();
+    } catch (error) {
+      reject(error);
+    }
+  }).catch(async (error) => {
+    if (retries < CONFIG.MAX_RETRIES) {
+      logger.warn(`请求失败: ${error.message}，${retries + 1}/${CONFIG.MAX_RETRIES} 重试...`);
+      await new Promise(r => setTimeout(r, 1000 * (retries + 1)));
+      return fetchPage(url, retries + 1);
+    }
+    throw new Error(`获取网页失败（已重试 ${CONFIG.MAX_RETRIES} 次）: ${error.message}`);
+  });
+}
+
+// ======================== HTML 解析 ========================
+function parseKeyGuideContent(html) {
+  const $ = cheerio.load(html);
+  const guides = [];
+
+  logger.log('开始解析 HTML...');
+
+  // 提取所有主要内容块（h2 为标题）
+  const h2Elements = $('h2').toArray();
+
+  h2Elements.forEach((elem, idx) => {
+    const title = $(elem).text().trim();
+
+    if (!title) return;
+
+    let content = '';
+    let description = '';
+    const examples = [];
+    const tags = [];
+    const references = [];
+
+    let currentElem = $(elem).next();
+    const nextH2Idx = h2Elements.findIndex((e, i) => i > idx);
+    const nextH2 = nextH2Idx >= 0 ? h2Elements[nextH2Idx] : null;
+
+    while (currentElem.length && (!nextH2 || !currentElem.is(nextH2))) {
+      const tag = currentElem[0]?.name;
+
+      // 处理段落（描述文本）
+      if (tag === 'p') {
+        const text = currentElem.text().trim();
+        if (description.length < 300) {
+          description += (description ? ' ' : '') + text;
+        }
+        content += `<p>${$(currentElem).html()}</p>\n`;
+      }
+
+      // 处理代码块/示例
+      if (tag === 'pre' || tag === 'code') {
+        const codeText = currentElem.text().trim();
+        if (codeText) {
+          content += `<pre><code>${escapeHtml(codeText)}</code></pre>\n`;
+        }
+      }
+
+      // 处理列表
+      if (tag === 'ul' || tag === 'ol') {
+        content += `<${tag}>${$(currentElem).html()}</${tag}>\n`;
+      }
+
+      // 处理强调文本
+      if (tag === 'strong' || tag === 'em') {
+        content += currentElem.html();
+      }
+
+      currentElem = currentElem.next();
+    }
+
+    // 清理描述文本
+    description = description
+      .replace(/[💡⚠️✅❌📝ℹ️📥📊🎯]/g, '')
+      .trim()
+      .substring(0, 300);
+
+    // 构建指南对象（简化版）
+    const guide = {
+      title: title,
+      description: description || title,
+      content: content.trim(),
+    };
+
+    guides.push(guide);
+    logger.info(`✓ 指南: ${title}`);
+  });
+
+  return guides;
+}
+
+// ======================== 辅助函数 ========================
+// 已移除，简化解析逻辑
+
+// ======================== JavaScript 代码生成 ========================
+
+function generateJavaScriptCode(guides) {
+  const now = new Date().toISOString();
+  const metadata = {
+    title: 'CloudCC 安全标记知识库',
+    description: '详细的安全标记使用指南，涵盖开发者密钥、安全标记配置等安全相关主题',
+    sourceUrl: CONFIG.SOURCE_URL,
+    generatedAt: now,
+    version: '1.0.0',
+  };
+
+  const guidesJson = JSON.stringify(guides, null, 2);
+  const metadataJson = JSON.stringify(metadata, null, 2);
+
+  const code = `/**
+ * CloudCC 安全标记知识库
+ * 
+ * 自动生成的文件，请勿手动修改
+ * 生成时间: ${now}
+ * 来源: ${CONFIG.SOURCE_URL}
+ */
+
+const metadata = ${metadataJson};
+
+const guides = ${guidesJson};
+
+const knowledge = {
+  ...metadata,
+  guides,
+};
+
+// 导出知识库
+module.exports = knowledge;
+`;
+
+  return code;
+}
+
+// ======================== 主函数 ========================
+
+async function main() {
+  try {
+    logger.log('🚀 CloudCC 安全标记知识库爬取脚本启动');
+    logger.info(`源 URL: ${CONFIG.SOURCE_URL}`);
+    logger.info(`输出文件: ${CONFIG.OUTPUT_FILE}`);
+
+    // 1. 获取网页
+    const html = await fetchPage(CONFIG.SOURCE_URL);
+
+    // 2. 解析网页
+    const guides = parseKeyGuideContent(html);
+
+    if (guides.length === 0) {
+      throw new Error('未能解析到任何指南，请检查网页结构');
+    }
+
+    logger.success(`成功解析 ${guides.length} 个指南`);
+
+    // 3. 生成 JavaScript 代码
+    const jsCode = generateJavaScriptCode(guides);
+
+    // 4. 写入文件
+    await fs.writeFile(CONFIG.OUTPUT_FILE, jsCode, 'utf-8');
+    logger.success(`成功生成 ${CONFIG.OUTPUT_FILE}`);
+
+    // 5. 统计信息
+    const totalContent = guides.reduce((sum, g) => sum + g.content.length, 0);
+
+    logger.log('📊 爬取统计:');
+    console.error(`   - 指南数: ${guides.length}`);
+    console.error(`   - 总内容大小: ${(totalContent / 1024).toFixed(2)} KB`);
+    console.error(`   - 文件大小: ${(jsCode.length / 1024).toFixed(2)} KB`);
+
+    logger.success('✨ 爬取完成！');
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+// 执行
+main();

package/src/mcp/tools/Developer Key Setup Guide/handler.js

@@ -0,0 +1,43 @@
+/**
+ * Key Guide Handler
+ * 处理安全标记知识库相关的查询
+ * 通过关键词匹配返回所有相关内容
+ */
+
+const knowledge = require('./prompt.js');
+
+/**
+ * 获取安全标记知识库的完整指南
+ * @returns {Object}
+ */
+function getKeyGuide() {
+  // 格式化输出所有指南
+  let output = `# ${knowledge.title}\n\n`;
+  output += `${knowledge.description}\n\n`;
+  output += `**来源**: ${knowledge.sourceUrl}\n`;
+  output += `**更新时间**: ${knowledge.generatedAt}\n\n`;
+  output += `---\n\n`;
+
+  // 输出每个指南
+  knowledge.guides.forEach((guide, index) => {
+    if (guide.title && guide.content) {
+      output += `## ${index + 1}. ${guide.title}\n\n`;
+      if (guide.description && guide.description !== guide.title) {
+        output += `${guide.description}\n\n`;
+      }
+      output += `${guide.content}\n\n`;
+      output += `---\n\n`;
+    }
+  });
+
+  return {
+    content: [{
+      type: 'text',
+      text: output
+    }]
+  };
+}
+
+module.exports = {
+  getKeyGuide
+};

package/src/mcp/tools/Developer Key Setup Guide/prompt.js

@@ -0,0 +1,71 @@
+/**
+ * CloudCC 安全标记知识库
+ * 
+ * 自动生成的文件，请勿手动修改
+ * 生成时间: 2025-12-04T12:06:58.620Z
+ * 来源: https://help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/
+ */
+
+const metadata = {
+  "title": "CloudCC 安全标记知识库",
+  "description": "详细的安全标记使用指南，涵盖开发者密钥、安全标记配置等安全相关主题",
+  "sourceUrl": "https://help.cloudcc.cn/devlearn01/huo-qu-an-quan-biao-ji/",
+  "generatedAt": "2025-12-04T12:06:58.620Z",
+  "version": "1.0.0"
+};
+
+const guides = [
+  {
+    "title": "获取开发者密钥",
+    "description": "获取开发者密钥，包括：safetyMark，CloudCCDev",
+    "content": ""
+  },
+  {
+    "title": "创建开发者账号",
+    "description": "1：访问CRM登录地址，使用系统管理账号登录到CRM系统，点击右上角齿轮，进入后台设置 2：选择菜单中的：用户管理——新建 3：重点：新建用户时，要分配具有开发者权限的简档 4：访问路径：管理用户——>简档——>对应的简档——>普通用户权限——>代码管理。确认此权限已经开启。",
+    "content": "<p>1：访问CRM登录地址，使用系统管理账号登录到CRM系统，点击右上角齿轮，进入后台设置</p>\n<p>2：选择菜单中的：用户管理——新建</p>\n<p>3：重点：新建用户时，要分配具有开发者权限的简档</p>\n<p>4：访问路径：管理用户——&gt;简档——&gt;对应的简档——&gt;普通用户权限——&gt;代码管理。确认此权限已经开启。</p>"
+  },
+  {
+    "title": "获取密钥",
+    "description": "1：访问CRM登录地址，使用开发者账号登录CRM系统，点击右上角齿轮，访问后台设置 2：选择用户及控制——安全性控制——连接的应用程序——新建 3：按要求填写：连接的应用程序名称，API名称，联系人电子邮件 4：创建好之后，进入详情页，点击CloudCC Dev后面的复制按钮，保留备用。",
+    "content": "<p>1：访问CRM登录地址，使用开发者账号登录CRM系统，点击右上角齿轮，访问后台设置</p>\n<p>2：选择用户及控制——安全性控制——连接的应用程序——新建</p>\n<p>3：按要求填写：连接的应用程序名称，API名称，联系人电子邮件</p>\n<p>4：创建好之后，进入详情页，点击CloudCC Dev后面的复制按钮，保留备用。</p>"
+  },
+  {
+    "title": "获取安全标记",
+    "description": "1：访问CRM登录地址，使用开发者账号，登录CRM，访问后台设置 2：访问 常规 → 个人设置 → 重置我的安全标记。点击后，安全标记将发送到个人信息中所配置的邮箱。。",
+    "content": "<p>1：访问CRM登录地址，使用开发者账号，登录CRM，访问后台设置</p>\n<p>2：访问 <strong>常规 → 个人设置 → 重置我的安全标记</strong>。点击后，安全标记将发送到个人信息中所配置的邮箱。。</p>"
+  },
+  {
+    "title": "配置密钥",
+    "description": "1：打开模版项目，打开根目录中的cloudcc-cli.config.js文件，将刚刚获取的2个密钥配置到对应的变量上。",
+    "content": "<p>1：打开模版项目，打开根目录中的cloudcc-cli.config.js文件，将刚刚获取的2个密钥配置到对应的变量上。</p>\n<pre><code>module.exports =\n{   // 使用dev环境\n    &quot;use&quot;: &quot;dev&quot;,\n    // dev环境密钥\n    &quot;dev&quot;: {\n            &quot;safetyMark&quot;: &quot;安全标记&quot;,\n            &quot;CloudCCDev&quot;: &quot;开发者密钥&quot;\n          },\n    // prod环境密钥\n    &quot;prod&quot;: {\n            &quot;safetyMark&quot;: &quot;安全标记&quot;,\n            &quot;CloudCCDev&quot;: &quot;开发者密钥&quot;\n          },\n}</code></pre>"
+  },
+  {
+    "title": "私有云特殊配置",
+    "description": "私有云特殊配置",
+    "content": "<ul><li>私有云除了以上2个配置还需要加入一个配置，用户标记为私有云环境</li></ul>\n<pre><code>module.exports =\n{   // 使用dev环境\n    &quot;use&quot;: &quot;dev&quot;,\n    // dev环境密钥\n    &quot;dev&quot;: {\n            &quot;safetyMark&quot;: &quot;安全标记&quot;,\n            &quot;CloudCCDev&quot;: &quot;开发者密钥&quot;,\n            &quot;version&quot;:&quot;private&quot;\n          },\n    // prod环境密钥\n    &quot;prod&quot;: {\n            &quot;safetyMark&quot;: &quot;安全标记&quot;,\n            &quot;CloudCCDev&quot;: &quot;开发者密钥&quot;,\n            &quot;version&quot;:&quot;private&quot;\n          },\n}</code></pre>"
+  },
+  {
+    "title": "特殊配置",
+    "description": "特殊配置",
+    "content": "<pre><code>&quot;dev&quot;: {\n   // 服务访问地址：\n   // 国内默认：https://developer.apis.cloudcc.cn\n   // 海外默认：https://developer.apis.cloudcc.com\n   // 私有云：登录CRM系统，页面鼠标右键，选择检查，选择控制台，输入以下代码获取：$CCDK.CCConfig.getBaseUrl()\n  &quot;baseUrl&quot;: &quot;http://xxx&quot;,\n   // 组件进入后台，销毁时间，设置10分钟销毁10*60*1000\n  &quot;destroyTimeout&quot;: 600000,\n  // 开发者平台在网关配置的前缀名，注意url不要以/结尾\n  &quot;devSvcDispatch&quot;：&quot;/devconsole&quot;,\n  // api-service-svc访问网关前缀地址，注意url不要以/结尾\n  &quot;apiSvcPrefix&quot;:&quot;/xxx&quot;,\n  // setup-svc访问网关前缀地址，注意url不要以/结尾\n  &quot;setupSvcPrefix&quot;:&quot;/xxx&quot;\n},</code></pre>"
+  },
+  {
+    "title": "多环境配置",
+    "description": "cloudcc-cli.config.js支持配置多个环境信息，use用于区分使用哪个环境。",
+    "content": "<p>cloudcc-cli.config.js支持配置多个环境信息，use用于区分使用哪个环境。</p>\n<pre><code>module.exports = { \n    // 使用dev环境密钥，与dev连接\n    &quot;use&quot;: &quot;dev&quot;, \n    // dev环境密钥\n    &quot;dev&quot;: { &quot;safetyMark&quot;: &quot;xxx&quot;, &quot;CloudCCDev&quot;: &quot;xxx&quot; }, \n    // prod环境密钥\n    &quot;prod&quot;: { &quot;safetyMark&quot;: &quot;xxx&quot;, &quot;CloudCCDev&quot;: &quot;xxx&quot; } \n}</code></pre>"
+  },
+  {
+    "title": "On this page",
+    "description": "On this page",
+    "content": ""
+  }
+];
+
+const knowledge = {
+  ...metadata,
+  guides,
+};
+
+// 导出知识库
+module.exports = knowledge;

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
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Object Fields Retriever Handler
+ * 查询某个对象的字段列表（通过 objprefix 或 JSON 对象）
+ */
+
+const path = require('path');
+const fieldsGet = require('../../../fields/get');
+
+/**
+ * 获取对象字段
+ * @param {{ objprefix?: string, projectPath?: string, object?: object|string }} params
+ */
+async function getFields(params = {}) {
+    try {
+        const { objprefix, projectPath = process.cwd() } = params;
+        const resolvedPath = path.resolve(projectPath);
+
+        // Support both object JSON and raw prefix paramters. Prefer explicit object when provided.
+        let arg = objprefix
+        if (!arg) {
+            return { content: [{ type: 'text', text: '✗ 缺少参数: 需要 objprefix' }] };
+        }
+
+        const argv = [null, null, resolvedPath, objprefix];
+        const res = await fieldsGet(argv, true);
+
+        if (!res || (Array.isArray(res) && res.length === 0)) {
+            return { content: [{ type: 'text', text: '未找到任何字段' }] };
+        }
+
+        return { content: [{ type: 'text', text: JSON.stringify(res) }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 查询失败: ${error.message}` }] };
+    }
+}
+
+module.exports = { getFields };

package/src/mcp/tools/Object Fields Retriever/prompt.js

@@ -0,0 +1,10 @@
+/**
+ * Object Fields Retriever prompt / knowledge metadata
+ */
+const metadata = {
+    title: '查询对象字段 - CloudCC',
+    description: '通过对象前缀或对象描述 JSON 查询对象字段列表（包括字段名称和 API 名称）',
+    version: '1.0.0'
+}
+
+module.exports = metadata;

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

@@ -0,0 +1,43 @@
+/**
+ * Object List Retriever Handler
+ * 用于查询 CloudCC 中的对象：标准对象、自定义对象或两者
+ */
+
+const path = require('path');
+const objectGet = require('../../../object/get');
+/**
+ * 列出对象
+ * @param {{ type?: 'standard'|'custom'|'both', projectPath?: string }} params
+ */
+async function listObjects(params = {}) {
+    try {
+        const { type = 'both', projectPath = process.cwd() } = params;
+        const resolvedPath = path.resolve(projectPath);
+
+        // Map our 'both' to no explicit type to get the combined list
+        const getType = type === 'both' ? undefined : type;
+
+        const argv = [null, null, resolvedPath, getType];
+        const objList = await objectGet(argv, true);
+        if (!objList || objList.length === 0) {
+            return { content: [{ type: 'text', text: '未找到任何对象' }] };
+        }
+        // no limit: list all objects
+        return { content: [{ type: 'text', text: JSON.stringify(objList) }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 查询失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    listObjects
+};
+
+
+
+
+
+
+
+
+

package/src/mcp/tools/Object List Retriever/prompt.js

@@ -0,0 +1,10 @@
+/**
+ * Object List Retriever prompt / knowledge metadata
+ */
+const metadata = {
+    title: '查询对象列表 - CloudCC',
+    description: '查询 CloudCC 中的对象列表，支持标准对象、自定义对象或两者。',
+    version: '1.0.0'
+}
+
+module.exports = metadata;

package/src/mcp/tools/Scheduled Class Creator/handler.js

@@ -0,0 +1,37 @@
+/**
+ * Scheduled Class Creator 工具处理器
+ * 创建定时类
+ */
+
+const path = require('path');
+const createScheduleModule = require('../../../timer/create');
+
+/**
+ * 创建定时类
+ */
+async function createSchedule({ scheduleName, projectPath = process.cwd() }) {
+    try {
+        // 临时改变工作目录以兼容原有模块
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            await createScheduleModule(scheduleName);
+            const schedulePath = path.resolve(projectPath, `schedule/${scheduleName}`);
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 创建成功！\n\n定时类路径: ${schedulePath}\n生成的文件:\n  - ${scheduleName}.java (主类文件，继承 CCSchedule)\n  - config.json (配置文件)\n\n定时类与自定义类的区别：\n  - 定时类继承 CCSchedule，用于定时任务执行\n  - 代码写在构造函数中，系统会按设定的时间调度执行`
+                }]
+            };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 创建失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    createSchedule
+};

package/src/mcp/tools/Scheduled Class Detail Retriever/handler.js

@@ -0,0 +1,34 @@
+/**
+ * Scheduled Class Detail Retriever 工具处理器
+ * 获取定时类的详细信息
+ */
+
+const detailModule = require('../../../timer/detail');
+
+/**
+ * 获取定时类详细信息
+ * @param {Object} params - 参数对象
+ * @param {string} params.scheduleName - 定时类名（可选，优先使用）
+ * @param {string} params.scheduleId - 定时类ID（可选，当没有scheduleName时使用）
+ * @param {string} params.projectPath - 项目路径（可选，默认为当前工作目录）
+ */
+async function getScheduleDetail({ scheduleName, scheduleId, projectPath = process.cwd() }) {
+    try {
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            const detail = await detailModule(scheduleName, scheduleId);
+            return { content: [{ type: 'text', text: JSON.stringify(detail, null, 2) }] };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    getScheduleDetail
+};
+