cloudcc-cli 2.2.3 → 2.2.4

package/src/mcp/index.js

@@ -12,216 +12,620 @@ const { z } = require("zod");
 
 // 导入各个工具的处理器
 const ccdkHandler = require("./tools/ccdk/handler.js");
-const devEnvHandler = require("./tools/dev-env/handler.js");
-const classesHandler = require("./tools/classes/handler.js");
-const keyGuideHandler = require("./tools/key-guide/handler.js");
-const pluginHandler = require("./tools/plugin/handler.js");
+const devEnvHandler = require("./tools/Dev Environment Creator/handler.js");
+const keyGuideHandler = require("./tools/Developer Key Setup Guide/handler.js");
+const devEnvValidatorHandler = require("./tools/Dev Environment Validator/handler.js");
+// 对象相关工具处理器
+const customObjectHandler = require('./tools/Object Creator/handler.js');
+const objectListHandler = require('./tools/Object List Retriever/handler.js');
+const objectFieldsHandler = require('./tools/Object Fields Retriever/handler.js');
+const fieldCreatorHandler = require('./tools/Object Fields Creator/handler.js');
+// 自定义类工具处理器
+const classesHandler = require("./tools/Class List Retriever/handler.js");
+const classCreatorHandler = require('./tools/Class Creator/handler.js');
+const classPublisherHandler = require('./tools/Class Publisher/handler.js');
+const classPullerHandler = require('./tools/Class Puller/handler.js');
+const classDetailHandler = require('./tools/Class Detail Retriever/handler.js');
+const classEditorGuideHandler = require('./tools/Class Editor Guide/handler.js');
+// 定时类工具处理器
+const scheduleCreatorHandler = require('./tools/Scheduled Class Creator/handler.js');
+const scheduleListHandler = require('./tools/Scheduled Class List Retriever/handler.js');
+const scheduleDetailHandler = require('./tools/Scheduled Class Detail Retriever/handler.js');
+const schedulePullerHandler = require('./tools/Scheduled Class Puller/handler.js');
+const schedulePublisherHandler = require('./tools/Scheduled Class Publisher/handler.js');
+// 触发器工具处理器
+const triggerCreatorHandler = require('./tools/Trigger Creator/handler.js');
+const triggerListHandler = require('./tools/Trigger List Retriever/handler.js');
+const triggerDetailHandler = require('./tools/Trigger Detail Retriever/handler.js');
+const triggerPullerHandler = require('./tools/Trigger Puller/handler.js');
+const triggerPublisherHandler = require('./tools/Trigger Publisher/handler.js');
+const triggerEditorGuideHandler = require('./tools/Trigger Editor Guide/handler.js');
+// 自定义组件工具处理器
+const componentCreatorHandler = require("./tools/Component Creator/handler.js");
+const componentListHandler = require('./tools/Component List Retriever/handler.js');
+const componentDetailHandler = require('./tools/Component Detail Retriever/handler.js');
+const componentEditorGuideHandler = require('./tools/Component Editor Guide/handler.js');
+const componentPullerHandler = require('./tools/Component Puller/handler.js');
+const componentPublisherHandler = require('./tools/Component Publisher/handler.js');
+// 客户端脚本工具处理器
+const clientScriptCreatorHandler = require('./tools/Client Script Creator/handler.js');
+const clientScriptListHandler = require('./tools/Client Script List Retriever/handler.js');
+const clientScriptDetailHandler = require('./tools/Client Script Detail Retriever/handler.js');
+const clientScriptEditorGuideHandler = require('./tools/Client Script Editor Guide/handler.js');
+const clientScriptPullerHandler = require('./tools/Client Script Puller/handler.js');
+const clientScriptPublisherHandler = require('./tools/Client Script Publisher/handler.js');
+// CloudCC 开发项目概要工具处理器
+const cloudccOverviewHandler = require('./tools/CloudCC Development Overview/handler.js');
 
 const mcpServer = new McpServer({
     name: 'cctool',
     version: '1.0.0'
 });
 
-// ==================== CCDK 工具 ====================
+// ==================== Dev Environment Validator ====================
+mcpServer.registerTool(
+    'get_dev_environment_validator',
+    {
+        description: '帮助开发者检查本地环境是否支持开发 CloudCC 应用（例如自定义组件、自定义类），并按步骤、关键词、平台或难度返回对应的操作或验证命令。',
+        inputSchema: z.object({
+            step: z.number().int().optional().describe('可选，按步骤号返回具体步骤'),
+            search: z.string().optional().describe('可选，按关键词搜索步骤'),
+            difficulty: z.enum(['easy', 'medium', 'hard']).optional().describe('可选，按难度过滤'),
+            platform: z.enum(['windows', 'macos', 'linux']).optional().describe('可选，按平台获取命令'),
+            command: z.boolean().optional().describe('可选，返回所有命令的汇总')
+        })
+    },
+    devEnvValidatorHandler.getDevEnvSetup
+);
 
-// Tool: Get CCDK documentation (full or by module)
+// ==================== Dev Environment Creator 工具 ====================
 mcpServer.registerTool(
-    'get_ccdk_docs',
+    'get_dev_environment_creator',
     {
-        description: '获取 CloudCC CCDK API 文档。可以获取完整文档或指定模块的文档（如 CCPage、CCDetail、CCList 等）',
-        inputSchema: {
-            module: z.string().optional().describe('可选：指定模块名称，如 "CCPage"、"CCDetail"、"CCCommon" 等。不指定则返回所有模块概览')
-        }
+        description: '获取 CloudCC 开发环境搭建指南，帮助用户按步骤完成开发环境的安装与配置。',
+        inputSchema: z.object({
+            step: z.number().int().optional(),
+            search: z.string().optional(),
+            difficulty: z.enum(['easy', 'medium', 'hard']).optional(),
+            platform: z.enum(['windows', 'macos', 'linux']).optional(),
+            command: z.boolean().optional(),
+        })
     },
-    ccdkHandler.getCcdkDocs
+    devEnvHandler.getDevEnvSetup
 );
 
-// Tool: Search CCDK documentation
+// ==================== Developer Key Setup Guide 工具 ====================
 mcpServer.registerTool(
-    'search_ccdk_docs',
+    'get_developer_key_setup_guide',
     {
-        description: '在 CCDK 文档中搜索关键词，支持搜索 API 名称、方法名、功能描述等',
-        inputSchema: {
-            keyword: z.string().describe('搜索关键词'),
-            maxResults: z.number().optional().default(20)
-        }
+        description: '创建完CloudCC模版项目后，获取 CloudCC 安全标记(safetyMark)和开发者密钥(CloudCCDev)相关的完整指南，以及配置方法。',
+        inputSchema: z.object({})
     },
-    ccdkHandler.searchCcdkDocs
+    keyGuideHandler.getKeyGuide
 );
 
-// Tool: List CCDK modules
+// ==================== Custom Object Creator ====================
 mcpServer.registerTool(
-    'list_ccdk_modules',
+    'create_custom_object',
     {
-        description: '列出 CCDK 所有可用的 API 模块',
-        inputSchema: {
-            showApis: z.boolean().optional().default(false)
-        }
+        description: '在 CloudCC CRM 系统中创建一个自定义对象（Custom Object），相当于数据库的表。',
+        inputSchema: z.object({
+            label: z.string().min(1).describe('对象的显示标签（例如: 客户）'),
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
+        })
     },
-    ccdkHandler.listCcdkModules
+    customObjectHandler.createCustomObject
 );
 
-// ==================== Dev-Env 工具 ====================
+// ==================== Object List Retriever ====================
+mcpServer.registerTool(
+    'get_object_list',
+    {
+        description: '查询CloudCC CRM 对象列表（标准对象、自定义对象或两者）',
+        inputSchema: z.object({
+            type: z.enum(['standard', 'custom', 'both']).optional().default('both').describe('查询类型：standard、custom、both'),
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
+        })
+    },
+    objectListHandler.listObjects
+);
 
-// Tool: Get dev environment setup guide
+
+// ==================== Object Fields Retriever ====================
 mcpServer.registerTool(
-    'get_dev_env_setup',
+    'get_object_fields',
     {
-        description: '获取 CloudCC 开发环境搭建指南',
+        description: '查询CloudCC CRM 某个对象的字段列表（通过对象前缀：objprefix，可通过 get_object_list 工具获取）',
         inputSchema: z.object({
-            step: z.number().int().optional(),
-            search: z.string().optional(),
-            difficulty: z.enum(['easy', 'medium', 'hard']).optional(),
-            platform: z.enum(['windows', 'macos', 'linux']).optional(),
-            command: z.boolean().optional(),
+            objprefix: z.string().describe('对象前缀：objprefix，可通过 get_object_list 工具获取'),
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
         })
     },
-    devEnvHandler.getDevEnvSetup
+    objectFieldsHandler.getFields
 );
 
-// ==================== Classes 工具 ====================
+// ==================== Object Fields Creator ====================
+mcpServer.registerTool(
+    'create_object_field',
+    {
+        description: '在 CloudCC CRM 对象中创建新字段。支持多种字段类型：S(文本)，U(URL)，SCORE(评分)，IMG(图片)，P(百分比)，C(币种)，J(文本区-长，最长32000字符)，H(电话)，E(电子邮件)，B(复选框)，A(富文本)，D(日期)，F(日期/时间)，T(时间)，N(数字)，ENC(加密文本-存储加密)，ENCD(加密文本-显示加密)，X(文本区，最多4000字符)，L(选项列表-单选)，Q(选项列表-多选)，AD(地址)，LT(地理定位，用于录入经纬度)，FL(文件)，Y(查找关系)，MR(查找多选)，M(主详信息关系)。',
+        inputSchema: z.object({
+            objid: z.string().min(1).describe('对象ID，可通过 get_object_list，create_custom_object，get_object_detail 工具获取，或手动输入ID'),
+            fieldType: z.enum(['S', 'U', 'SCORE', 'IMG', 'P', 'C', 'J', 'H', 'E', 'B', 'A', 'D', 'F', 'T', 'N', 'ENC', 'ENCD', 'X', 'L', 'Q', 'AD', 'LT', 'FL', 'Y', 'MR', 'M']).describe('字段类型：S(文本)，U(URL)，SCORE(评分)，IMG(图片)，P(百分比)，C(币种)，J(文本区-长，最长32000字符)，H(电话)，E(电子邮件)，B(复选框)，A(富文本)，D(日期)，F(日期/时间)，T(时间)，N(数字)，ENC(加密文本-存储加密)，ENCD(加密文本-显示加密)，X(文本区，最多4000字符)，L(选项列表-单选)，Q(选项列表-多选)，AD(地址)，LT(地理定位，用于录入经纬度)，FL(文件)，Y(查找关系)，MR(查找多选)，M(主详信息关系)'),
+            nameLabel: z.string().min(1).describe('字段名称，必填字段'),
+            projectPath: z.string().optional().describe('项目根路径，默认为当前工作目录'),
+            ptext: z.string().optional().describe('选项列表文本，多个选项用\\r\\n分隔，当字段类型为L(选项列表-单选)或Q(选项列表-多选)时必填'),
+            lookupObj: z.string().optional().describe('查找关系对象ID，当字段类型为Y(查找关系)、MR(查找多选)或M(主详信息关系)时必填'),
+        })
+    },
+    fieldCreatorHandler.createObjectField
+);
 
-// Tool: Create custom class
+// ==================== Class List Retriever ====================
 mcpServer.registerTool(
-    'create_class',
+    'get_custom_class_list',
     {
-        description: '创建一个新的 CloudCC 自定义类，会在 classes/{ClassName}/ 目录下生成 Java 类文件、测试文件和配置文件',
+        description: '获取 CloudCC CRM 服务器上的自定义类列表',
         inputSchema: {
-            className: z.string().min(1).describe('Java 类名，必须符合 Java 命名规范（字母开头，只能包含字母、数字和下划线）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
         }
     },
-    classesHandler.createClass
+    classesHandler.listClasses
 );
 
-// Tool: Publish class to server
+// ==================== Class Detail Retriever 工具 ====================
 mcpServer.registerTool(
-    'publish_class',
+    'get_class_detail',
     {
-        description: '将本地自定义类发布到 CloudCC 服务器，只上传 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的代码',
-        inputSchema: {
-            className: z.string().min(1).describe('要发布的类名'),
+        description: '获取 CloudCC CRM 自定义类的详细信息（本地优先）。可以通过类名查询本地，也可以通过ID查询服务器。至少需要提供className或classId其中之一',
+        inputSchema: z.object({
+            className: z.string().optional().describe('类名（可选，优先从本地查询）'),
+            classId: z.string().optional().describe('类ID（可选，当没有className时从服务器查询）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    classesHandler.publishClass
+    classDetailHandler.getClassDetail
 );
 
-// Tool: Pull class from server
+// ==================== Class Puller 工具 ====================
 mcpServer.registerTool(
     'pull_class',
     {
-        description: '从 CloudCC 服务器拉取自定义类的最新代码，更新本地文件中 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的内容',
-        inputSchema: {
+        description: '从 CloudCC CRM 服务器拉取自定义类的最新代码，更新本地文件中 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的内容。如果本地不存在该类，会自动从服务器创建',
+        inputSchema: z.object({
             className: z.string().min(1).describe('要拉取的类名'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    classesHandler.pullClass
+    classPullerHandler.pullClass
 );
 
-// Tool: List classes
+// ==================== Class Publisher 工具 ====================
 mcpServer.registerTool(
-    'list_classes',
+    'publish_class',
     {
-        description: '获取 CloudCC 服务器上的自定义类列表',
-        inputSchema: {
-            queryParams: z.object({}).passthrough().optional().describe('查询条件，JSON 对象格式，例如 {"name": "MyClass"}'),
-            limit: z.number().int().positive().optional().default(20).describe('返回结果数量限制，默认 20'),
+        description: '将本地自定义类发布到 CloudCC CRM 服务器，只上传 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的代码',
+        inputSchema: z.object({
+            className: z.string().min(1).describe('要发布的类名'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    classPublisherHandler.publishClass
+);
+
+// ==================== Class Creator 工具 ====================
+mcpServer.registerTool(
+    'create_class',
+    {
+        description: '创建一个新的 CloudCC CRM 自定义类，会在 classes/{ClassName}/ 目录下生成 Java 类文件、测试文件和配置文件',
+        inputSchema: z.object({
+            className: z.string().min(1).describe('Java 类名，必须符合 Java 命名规范（字母开头，只能包含字母、数字和下划线）'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    classCreatorHandler.createClass
+);
+
+// ==================== Class Editor Guide 工具 ====================
+mcpServer.registerTool(
+    'get_class_editor_guide',
+    {
+        description: '【必读】编辑/修改/优化 CloudCC 自定义类和定时类时的完整指南。默认返回规范、最佳实践和API概要，需要详细API时再指定topic查询。',
+        inputSchema: z.object({
+            topic: z.enum([
+                'overview', 'ccservice', 'object', 'email', 'time', 'user', 'logger', 'scenarios'
+            ])
+                .optional()
+                .default('overview')
+                .describe(`编辑指南主题（建议先查看 overview）:
+- overview: 📋 规范 + 最佳实践 + 强制要求 + API概要（首选，包含所有重要信息）
+- ccservice: 📖 CCService 数据操作详细API（查询、新增、更新、删除）
+- object: 📖 CCObject 对象操作详细API
+- email: 📖 SendEmail 邮件服务详细API
+- time: 📖 TimeUtil 时间工具详细API
+- user: 📖 UserInfo 用户信息详细API
+- logger: 📖 DevLogger 日志输出详细API
+- scenarios: 💡 常见编辑场景完整示例`)
+        })
+    },
+    classEditorGuideHandler.editClass
+);
+
+// ==================== Scheduled Class Creator 工具 ====================
+mcpServer.registerTool(
+    'create_schedule',
+    {
+        description: '创建一个新的 CloudCC CRM 定时类，会在 schedule/{ScheduleName}/ 目录下生成继承 CCSchedule 的 Java 类文件和配置文件。定时类用于执行定时任务。',
+        inputSchema: z.object({
+            scheduleName: z.string().min(1).describe('定时类名，必须符合 Java 命名规范（字母开头，只能包含字母、数字和下划线）'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    scheduleCreatorHandler.createSchedule
+);
+
+// ==================== Scheduled Class List Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_schedule_list',
+    {
+        description: '获取 CloudCC CRM 服务器上的定时类列表',
+        inputSchema: z.object({
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    classesHandler.listClasses
+    scheduleListHandler.listSchedules
 );
 
-// Tool: Get class detail
+// ==================== Scheduled Class Detail Retriever 工具 ====================
 mcpServer.registerTool(
-    'get_class_detail',
+    'get_schedule_detail',
     {
-        description: '获取本地自定义类的详细信息，包括配置、文件路径和源码预览',
-        inputSchema: {
-            className: z.string().min(1).describe('类名'),
+        description: '获取 CloudCC CRM 定时类的详细信息（本地优先）。可以通过定时类名查询本地，也可以通过ID查询服务器。至少需要提供scheduleName或scheduleId其中之一',
+        inputSchema: z.object({
+            scheduleName: z.string().optional().describe('定时类名（可选，优先从本地查询）'),
+            scheduleId: z.string().optional().describe('定时类ID（可选，当没有scheduleName时从服务器查询）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    classesHandler.getClassDetail
+    scheduleDetailHandler.getScheduleDetail
 );
 
-// Tool: Pull multiple classes
+// ==================== Scheduled Class Puller 工具 ====================
 mcpServer.registerTool(
-    'pull_multiple_classes',
+    'pull_schedule',
     {
-        description: '批量从 CloudCC 服务器拉取多个自定义类，适用于初始化项目或批量下载。遇到错误会继续处理其他类，最后返回统计结果',
-        inputSchema: {
-            classIds: z.array(z.string()).min(1).describe('要拉取的类 ID 数组，例如 ["id1", "id2", "id3"]'),
+        description: '从 CloudCC CRM 服务器拉取定时类的最新代码，更新本地文件中 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的内容。如果本地不存在该定时类，会自动从服务器创建',
+        inputSchema: z.object({
+            scheduleName: z.string().min(1).describe('要拉取的定时类名'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    schedulePullerHandler.pullSchedule
+);
+
+// ==================== Scheduled Class Publisher 工具 ====================
+mcpServer.registerTool(
+    'publish_schedule',
+    {
+        description: '将本地定时类发布到 CloudCC CRM 服务器，只上传 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的代码',
+        inputSchema: z.object({
+            scheduleName: z.string().min(1).describe('要发布的定时类名'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    classesHandler.pullMultipleClasses
+    schedulePublisherHandler.publishSchedule
 );
 
-// Tool: Edit class with knowledge base
+// ==================== Trigger Creator 工具 ====================
 mcpServer.registerTool(
-    'edit_class',
+    'create_trigger',
     {
-        description: '获取编辑 CloudCC 自定义类时所需的知识库、API 文档和代码示例。包含 CCService、CCObject、SendEmail、TimeUtil、UserInfo、DevLogger 等核心 API 的详细使用说明。代码示例和最佳实践会自动附加 CloudCC 标准 API 规范检查表，确保编辑后的代码符合 CloudCC 官方标准',
-        inputSchema: {
-            topic: z.enum(['overview', 'ccservice', 'object', 'email', 'time', 'user', 'logger', 'scenarios', 'bestpractices'])
+        description: '创建一个新的 CloudCC CRM 触发器，会在 triggers/{objectName}/{triggerName}/ 目录下生成继承 CCTrigger 的 Java 类文件和配置文件。触发器用于在对象操作时执行特定逻辑。',
+        inputSchema: z.object({
+            triggerName: z.string().min(1).describe('触发器名称，必须符合 Java 命名规范（字母开头，只能包含字母、数字和下划线）'),
+            objectName: z.string().min(1).describe('对象名称（schemetableName），触发器关联的对象'),
+            targetObjectId: z.string().min(1).describe('目标对象ID'),
+            triggerTime: z.string().min(1).describe('触发时间（例如：beforeInsert, beforeUpdate, beforeUpsert, beforeDelete, afterInsert, afterUpdate, afterUpsert, afterDelete, afterInsertCommit, afterUpdateCommit, afterUpsertCommit, afterDeleteCommit, approval, beforeBatch, afterBatch, commitBatch）'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    triggerCreatorHandler.createTrigger
+);
+
+// ==================== Trigger List Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_trigger_list',
+    {
+        description: '获取 CloudCC CRM 服务器上的触发器列表，可选筛选条件',
+        inputSchema: z.object({
+            triggerName: z.string().optional().describe('可选，触发器名称（用于筛选）'),
+            targetObjectId: z.string().optional().describe('可选，目标对象ID（用于筛选）'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    triggerListHandler.listTriggers
+);
+
+// ==================== Trigger Detail Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_trigger_detail',
+    {
+        description: '获取 CloudCC CRM 触发器的详细信息（本地优先）。可以通过触发器路径查询本地，也可以通过ID查询服务器。至少需要提供triggerPath或triggerId其中之一',
+        inputSchema: z.object({
+            triggerPath: z.string().optional().describe('触发器路径 "objectName/triggerName"（可选，优先从本地查询）'),
+            triggerId: z.string().optional().describe('触发器ID（可选，当没有triggerPath时从服务器查询）'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    triggerDetailHandler.getTriggerDetail
+);
+
+// ==================== Trigger Puller 工具 ====================
+mcpServer.registerTool(
+    'pull_trigger',
+    {
+        description: '从 CloudCC CRM 服务器拉取触发器的最新代码到本地，更新本地文件中 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的内容。如果本地不存在该触发器，会自动从服务器创建',
+        inputSchema: z.object({
+            id: z.string().min(1).describe('要拉取的触发器ID'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    triggerPullerHandler.pullTrigger
+);
+
+// ==================== Trigger Publisher 工具 ====================
+mcpServer.registerTool(
+    'publish_trigger',
+    {
+        description: '将本地触发器发布到 CloudCC CRM 服务器，只上传 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的代码',
+        inputSchema: z.object({
+            triggerPath: z.string().min(1).describe('要发布的触发器路径 "objectName/triggerName"'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    triggerPublisherHandler.publishTrigger
+);
+
+// ==================== Trigger Editor Guide 工具 ====================
+mcpServer.registerTool(
+    'get_trigger_editor_guide',
+    {
+        description: '【必读】编辑/修改/优化 CloudCC 触发器时的完整指南。触发器与自定义类、定时类共享相同的API。默认返回规范、最佳实践和API概要，需要详细API时再指定topic查询。',
+        inputSchema: z.object({
+            topic: z.enum([
+                'overview', 'ccservice', 'object', 'email', 'time', 'user', 'logger', 'scenarios'
+            ])
                 .optional()
                 .default('overview')
-                .describe(`知识库主题:
-- overview: 类概览和快速导航
-- ccservice: CCService 数据操作 API（查询、新增、更新、删除等）
-- object: CCObject 对象操作方法
-- email: SendEmail 邮件服务
-- time: TimeUtil 时间格式化工具
-- user: UserInfo 用户信息获取
-- logger: DevLogger 日志输出
-- scenarios: 常见编辑场景示例
-- bestpractices: 编辑最佳实践`)
-        }
+                .describe(`编辑指南主题（建议先查看 overview）:
+- overview: 📋 规范 + 最佳实践 + 强制要求 + API概要（首选，包含所有重要信息）
+- ccservice: 📖 CCService 数据操作详细API（查询、新增、更新、删除）
+- object: 📖 CCObject 对象操作详细API
+- email: 📖 SendEmail 邮件服务详细API
+- time: 📖 TimeUtil 时间工具详细API
+- user: 📖 UserInfo 用户信息详细API
+- logger: 📖 DevLogger 日志输出详细API
+- scenarios: 💡 常见编辑场景完整示例`)
+        })
     },
-    classesHandler.editClass
+    triggerEditorGuideHandler.editTrigger
 );
 
-// ==================== Key Guide 工具 ====================
+// ==================== Component Creator 工具 ====================
+mcpServer.registerTool(
+    'create_custom_component',
+    {
+        description: '创建一个新的 CloudCC Vue 自定义组件。基于vue2.x的组件创建，会生成主组件文件、子组件目录和配置文件',
+        inputSchema: z.object({
+            pluginName: z.string().min(1).describe('插件名称，用于创建目录和主文件，命名规范，必须符合dom-element-name规范'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    componentCreatorHandler.createCustomComponent
+);
 
-// Tool: Get security key guide
+// ==================== Component Publisher 工具 ====================
 mcpServer.registerTool(
-    'get_key_guideeee',
+    'publish_custom_component',
     {
-        description: '获取 CloudCC 安全标记和开发者密钥相关的完整指南，包括获取开发者密钥、安全标记、配置方法等',
-        inputSchema: z.object({})
+        description: '将 Vue 自定义组件编译并发布到 CloudCC 服务器，必须使用返回的命令，在控制台执行',
+        inputSchema: z.object({
+            componentName: z.string().min(1).describe('要发布的组件名称'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
     },
-    keyGuideHandler.getKeyGuide
+    componentPublisherHandler.publishCustomComponent
 );
 
-// ==================== Plugin 工具 ====================
+// ==================== Component List Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_custom_component_list',
+    {
+        description: '获取 CloudCC CRM 服务器上的自定义组件列表（本地和服务器）',
+        inputSchema: z.object({
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    componentListHandler.listCustomComponents
+);
 
-// Tool: Create plugin
+// ==================== Component Detail Retriever 工具 ====================
 mcpServer.registerTool(
-    'create_plugin',
+    'get_custom_component_detail',
     {
-        description: '创建一个新的 CloudCC Vue 自定义组件，会在 plugins/{pluginName}/ 目录下生成主组件文件、子组件目录和配置文件',
-        inputSchema: {
-            pluginName: z.string().min(1).describe('插件名称，用于创建目录和主文件'),
+        description: '获取 CloudCC CRM 自定义组件的详细信息（本地优先）。可以通过组件名查询本地，也可以通过ID查询服务器。至少需要提供componentName或componentId其中之一',
+        inputSchema: z.object({
+            componentName: z.string().optional().describe('组件名称（可选，优先从本地查询）'),
+            componentId: z.string().optional().describe('组件ID（可选，当没有componentName时从服务器查询）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        })
     },
-    pluginHandler.createPlugin
+    componentDetailHandler.getCustomComponentDetail
 );
 
-// Tool: Publish plugin
+// ==================== Component Editor Guide 工具 ====================
 mcpServer.registerTool(
-    'publish_plugin',
+    'get_component_editor_guide',
     {
-        description: '将 Vue 自定义组件编译并发布到 CloudCC 服务器。会自动收集所有依赖、编译为 UMD 格式并上传',
-        inputSchema: {
-            pluginName: z.string().min(1).describe('要发布的插件名称'),
+        description: '【必读】编辑/修改/优化 CloudCC 自定义组件时的完整指南。默认返回规范、最佳实践和API概要，需要详细API时再指定topic查询。',
+        inputSchema: z.object({
+            topic: z.enum([
+                'overview', 'component-structure', 'config', 'data-structure',
+                'style-scoped', 'publish-workflow', 'dependency', 'project-config',
+                'api', 'bestpractices', 'faq'
+            ])
+                .optional()
+                .default('overview')
+                .describe(`编辑指南主题（建议先查看 overview）:
+- overview: 📋 规范 + 最佳实践 + 强制要求 + API概要（首选，包含所有重要信息）
+- component-structure: 📖 组件结构说明
+- config: 📖 配置文件详解
+- data-structure: 📖 数据结构规范
+- style-scoped: 📖 样式作用域最佳实践
+- publish-workflow: 📖 发布流程详解
+- dependency: 📖 依赖收集机制
+- project-config: 📖 项目配置文件
+- api: 📖 API 参考文档
+- bestpractices: 💡 最佳实践
+- faq: ❓ 常见问题`)
+        })
+    },
+    componentEditorGuideHandler.editComponent
+);
+
+// ==================== Component Puller 工具 ====================
+mcpServer.registerTool(
+    'pull_custom_component',
+    {
+        description: '从 CloudCC CRM 服务器拉取自定义组件的最新代码到本地。支持通过组件名或ID拉取：如果传入组件名且本地存在，会从 config.json 读取 id 后拉取；如果传入 ID，直接通过 ID 拉取',
+        inputSchema: z.object({
+            componentName: z.string().optional().describe('组件名称（可选，如果本地存在会从 config.json 读取 id）'),
+            componentId: z.string().optional().describe('组件ID（可选，直接通过 ID 拉取）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
-        }
+        }).refine(data => data.componentName || data.componentId, {
+            message: '必须提供 componentName 或 componentId 其中之一'
+        })
+    },
+    componentPullerHandler.pullCustomComponent
+);
+
+// ==================== Client Script Creator 工具 ====================
+// mcpServer.registerTool(
+//     'create_client_script',
+//     {
+//         description: '创建一个新的 CloudCC 客户端脚本，会在 script/{objName}/{scriptName}/ 目录下生成脚本文件和配置文件。客户端脚本用于在页面加载、字段变更等事件时执行 JavaScript 代码。\n\npageId 选项：list (List View), detail (Detail View), edit (Edit View), add (New View)\nusageScenario 选项："" (All), "PC", "H5", "App"\nevent 选择范围根据 pageId 决定：\n- list: onCreated, onLoad, onDestroy\n- detail: onLoad\n- edit: onCreated, onLoad, onDestroy, beforeSave, afterSave\n- add: onCreated, onLoad, onDestroy, beforeSave, afterSave',
+//         inputSchema: z.object({
+//             scriptName: z.string().min(1).describe('脚本名称，必须符合 JavaScript 命名规范（字母开头，只能包含字母、数字和下划线）'),
+//             scriptDesc: z.string().optional().describe('脚本描述（可选）'),
+//             objId: z.string().min(1).describe('对象ID，从对象列表获取'),
+//             objName: z.string().min(1).describe('对象名称，脚本关联的对象'),
+//             schemetableName: z.string().min(1).describe('对象表名，从对象列表获取'),
+//             recordTypeId: z.string().optional().describe('记录类型ID，通过对象的objprefix查询获取（可选）'),
+//             recordTypeName: z.string().optional().describe('记录类型名称，通过对象的objprefix查询获取（可选）'),
+//             pageId: z.enum(['list', 'detail', 'edit', 'add']).describe('页面ID：list (List View), detail (Detail View), edit (Edit View), add (New View)'),
+//             eventType: z.string().optional().default('pageType').describe('事件类型，默认为 pageType（可选）'),
+//             event: z.string().min(1).describe('事件名称，根据 pageId 决定可选值：list(onCreated/onLoad/onDestroy), detail(onLoad), edit/add(onCreated/onLoad/onDestroy/beforeSave/afterSave)'),
+//             fieldId: z.string().optional().describe('字段ID（可选）'),
+//             usageScenario: z.enum(['', 'PC', 'H5', 'App']).optional().default('').describe('使用场景："" (All), "PC", "H5", "App"（可选）'),
+//             projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+//         })
+//     },
+//     clientScriptCreatorHandler.createClientScript
+// );
+
+// ==================== Client Script List Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_client_script_list',
+    {
+        description: '获取 CloudCC CRM 服务器上的客户端脚本列表',
+        inputSchema: z.object({
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录'),
+            condition: z.object({
+                id: z.string().optional().describe('脚本ID（用于筛选）'),
+                pageLabel: z.string().optional().describe('页面标签（用于筛选）'),
+                objName: z.string().optional().describe('对象名称（用于筛选）')
+            }).optional().describe('查询条件（可选）')
+        })
+    },
+    clientScriptListHandler.listClientScripts
+);
+
+// ==================== Client Script Detail Retriever 工具 ====================
+mcpServer.registerTool(
+    'get_client_script_detail',
+    {
+        description: '获取 CloudCC CRM 客户端脚本的详细信息（本地优先）。可以通过脚本路径查询本地，也可以通过ID查询服务器。至少需要提供scriptPath或scriptId其中之一',
+        inputSchema: z.object({
+            scriptPath: z.string().optional().describe('脚本路径 "objName/scriptName"（可选，优先从本地查询）'),
+            scriptId: z.string().optional().describe('脚本ID（可选，当没有scriptPath时从服务器查询）'),
+            projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
+        }).refine(data => data.scriptPath || data.scriptId, {
+            message: '必须提供 scriptPath 或 scriptId 其中之一'
+        })
+    },
+    clientScriptDetailHandler.getClientScriptDetail
+);
+
+// ==================== Client Script Editor Guide 工具 ====================
+mcpServer.registerTool(
+    'get_client_script_editor_guide',
+    {
+        description: '【必读】编辑/修改/优化 CloudCC 客户端脚本时的完整指南。默认返回规范、最佳实践和API概要，需要详细API时再指定topic查询。使用CCDK知识库提供API参考。',
+        inputSchema: z.object({
+            topic: z.enum([
+                'overview', 'structure', 'config', 'ccdk-api', 'bestpractices', 'faq'
+            ])
+                .optional()
+                .default('overview')
+                .describe(`编辑指南主题（建议先查看 overview）:
+- overview: 📋 规范 + 最佳实践 + 强制要求 + API概要（首选，包含所有重要信息）
+- structure: 📖 脚本结构说明
+- config: 📖 配置文件详解
+- ccdk-api: 📖 CCDK API 参考文档
+- bestpractices: 💡 最佳实践
+- faq: ❓ 常见问题`)
+        })
+    },
+    clientScriptEditorGuideHandler.editClientScript
+);
+
+// ==================== Client Script Puller 工具 ====================
+mcpServer.registerTool(
+    'pull_client_script',
+    {
+        description: '从 CloudCC CRM 服务器拉取客户端脚本的最新代码到本地。支持通过脚本路径或ID拉取：如果传入脚本路径且本地存在，会从 config.json 读取 id 后拉取；如果传入 ID，直接通过 ID 拉取并自动创建目录和文件',
+        inputSchema: z.object({
+            scriptPath: z.string().optional().describe('脚本路径 "objName/scriptName"（可选，如果本地存在会从 config.json 读取 id）'),
+            scriptId: z.string().optional().describe('脚本ID（可选，直接通过 ID 拉取，会自动创建目录和文件）'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        }).refine(data => data.scriptPath || data.scriptId, {
+            message: '必须提供 scriptPath 或 scriptId 其中之一'
+        })
+    },
+    clientScriptPullerHandler.pullClientScript
+);
+
+// ==================== Client Script Publisher 工具 ====================
+mcpServer.registerTool(
+    'publish_client_script',
+    {
+        description: '将本地客户端脚本发布到 CloudCC CRM 服务器，只上传 function main($CCDK, obj) 函数体内的代码',
+        inputSchema: z.object({
+            scriptPath: z.string().min(1).describe('脚本路径 "objName/scriptName"'),
+            projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
+        })
+    },
+    clientScriptPublisherHandler.publishClientScript
+);
+
+// ==================== CloudCC Development Overview 工具 ====================
+mcpServer.registerTool(
+    'get_cloudcc_development_overview',
+    {
+        description: 'CloudCC 开发项目概要信息，开始开发前必须查看，用于快速了解CloudCC开发平台',
+        inputSchema: z.object({})
     },
-    pluginHandler.publishPlugin
+    cloudccOverviewHandler.getCloudCCDevelopmentOverview
 );
 
 module.exports = mcpServer;