CloudCC MCP Tool

1.审批类工具（src/tools/approval_tools.py）

用于拉取待审批列表、单条审批通过/拒绝、批量审批等（包含“二次确认”保护）。

• get_pending_approvals
  • 用途：拉取待审批记录列表（分页）
  • 关键入参：token、api_svc、page_num、page_size
  • 输出特点：提示调用方用 Markdown 表格展示，并要求表格最后两列包含 objid 与 workItemId
• approve_record（危险操作）
  • 用途：审批通过单条审批记录
  • 关键入参：objid、workItemid、token、api_svc、confirm
  • 安全约束：必须 confirm=true 才会执行
• reject_record（危险操作）
  • 用途：拒绝单条审批记录
  • 关键入参：objid、workItemid、comment、token、api_svc、confirm
  • 安全约束：必须 confirm=true；comment 必填
• batch_approve（危险操作）
  • 用途：按 workItemids 批量批准/拒绝
  • 关键入参：workItemids、approve_type（Approved/Rejected）、token、api_svc、confirm
  • 安全约束：必须 confirm=true

2. CRM 前端动作/跳转工具（src/tools/crm_bridge_tools.py）

用于“打开页面/列表/详情/新建/编辑”等前端动作，统一返回 jsonType=cc_action 的结构化配置（给前端/容器执行跳转或打开组件）。

• 审批页面
  • __action__open_approval：打开审批列表或审批详情（详情需 objid/workItemid/objname/objtype）
• 对象页面
  • __action__open_object_list：打开对象列表页（可选 viewId）
  • __action__open_object_detail：打开记录详情页（id）
  • __action__open_create_page：打开对象新建页（objid/objectApi/prefix）
  • __action__open_edit_page：打开对象编辑页（含记录 id）
• 标准导航页
  • __action__open_standard_page：主页/报表列表/仪表板列表/价格手册列表/表单列表/预测/文件列表（pageType）
• 标准详情页
  • __action__open_detail_page：报表/仪表板/价格手册/文件详情（detailType + id）
• 公海池
  • __action__open_pool_list：打开公海池列表（lead 或 account）
• 表单
  • __action__open_form_detail：打开表单详情（id/dataid/objectid，可选 ownerobjectid）
• 邮件
  • __action__open_email
    • 用途：打开邮件页面；或在 emailType="analyze" 时拉取近 3 天邮件并要求总结建议
    • 分析邮件入参：mailUser、mailpsw（IMAP 授权密码）
• 自定义页面
  • __action__open_custom_page：打开自定义页面（pageApi）

3. 对象/元数据 & 数据查询工具（src/tools/object_tools.py）

覆盖对象创建、字段创建、对象列表/字段列表查询，以及基于 OpenAPI 的数据查询。

• 元数据/配置
  • create_custom_object：创建自定义对象（label，可选 nameLabel）
  • create_object_field：创建对象字段（字段类型丰富；选项字段用 ptext；关系字段用 lookupObj）
  • get_object_list：获取对象列表（standard/custom/all）
  • get_object_fields：按 objprefix 获取字段（标准字段 + 自定义字段）
• 数据查询（OpenAPI）
  • get_object_data
    • 用途：查询某对象数据（支持条件表达式 expressions、字段筛选 fields、条数 limit）
    • 关键约束：必须使用上下文中的 open_api_token（明确禁止用 token 代替）
  • get_multi_object_data
    • 用途：并发查询多个对象数据
    • 入参形式：queries 为 JSON 字符串数组（每项含 objapi/expressions/fields/limit）
    • 关键约束：同样必须使用 open_api_token

4. 自定义页面列表工具（src/tools/custom_page_tools.py）

• get_custom_pages
  • 用途：获取自定义页面列表
  • 关键入参：token、dev_svc

5. 应用工具（src/tools/application_tools.py）

• create_application
  • 用途：创建应用（Application），可绑定多个菜单
  • 关键入参：token、setup_svc、appName、appCode、menuIds（可选，逗号分隔）

6. 类（Class）工具（src/tools/class_tools.py）

• get_custom_class_list
  • 用途：获取服务器自定义类列表（返回简化字段：id/name/apiname）
  • 关键入参：token、setup_svc
• get_class_detail
  • 用途：获取自定义类详情（说明为“svc 版本仅远程查询语义”）
  • 关键入参：classId（优先）或 className
• get_class_editor_guide
  • 用途：返回“类编辑/修改/优化指南”（知识库文档）

7. 客户端脚本工具（src/tools/client_script_tools.py）

• get_client_script_list
  • 用途：获取客户端脚本列表
  • 关键入参：token、dev_svc、condition（可选 JSON 字符串过滤）
• get_client_script_detail
  • 用途：脚本详情（“远程语义”）
  • 关键入参：scriptId（优先）或 scriptPath
• get_client_script_editor_guide
  • 用途：客户端脚本编辑指南

8. 自定义组件工具（src/tools/component_tools.py）

• get_custom_component_list
  • 用途：组件列表（可按 compName 筛选）
  • 关键入参：token、dev_svc
• get_custom_component_detail
  • 用途：组件详情（“远程语义”）
  • 关键入参：pluginId（优先）或 pluginName
• get_component_editor_guide
  • 用途：组件编辑/发布指南

9.触发器工具（src/tools/trigger_tools.py）

• get_trigger_list
  • 用途：触发器列表（可按 triggerName/targetObjectId 筛选）
  • 关键入参：token、setup_svc
• get_trigger_detail
  • 用途：触发器详情（“远程语义”）
  • 关键入参：triggerId（优先）或 triggerPath
• get_trigger_editor_guide
  • 用途：触发器编辑知识库/指南

10. 定时类工具（src/tools/schedule_tools.py）

• get_schedule_list
  • 用途：定时类列表
  • 关键入参：token、setup_svc
• get_schedule_detail
  • 用途：定时类详情（“远程语义”）
  • 关键入参：scheduleId（优先）或 scheduleName

11. 菜单（标签页）工具（src/tools/menu_tools.py）

• create_menu
  • 用途：创建菜单（标签页），支持 object/page/script/site
  • 关键入参：token、setup_svc、menuType、resourceId、tabName
  • 可选入参：tabStyle/mobileimg/cloudccservicetab（图标相关默认值已提供）

12. CLI 桥接工具（只返回命令，不直接执行）（src/tools/cli_bridge_tools.py）

该模块用于把原 cloudcc-cli 的能力以 MCP 形式暴露，但本质是生成“可执行 CLI 命令/脚本预览”（结构化 JSON，含 shell_preview/cwd/notes），由使用者自行执行。

• 环境与配置
  • get_dev_environment_validator：返回环境检查命令列表（按平台）
  • get_dev_environment_creator：返回环境搭建步骤与命令
  • get_developer_key_setup_guide：开发者密钥配置检查/建议命令
  • get_cloudcc_development_overview：开发路线总览（CLI 路由清单）
• 类（Class）相关命令生成
  • create_class / pull_class / publish_class：生成 cc classes ... 命令
• 定时类（Schedule）相关命令生成
  • create_schedule / pull_schedule / publish_schedule：生成 cc timer ... 命令
• 触发器（Trigger）相关命令生成
  • create_trigger / pull_trigger / publish_trigger：生成 cc triggers ... 命令
• 组件（Plugin）相关命令生成
  • create_custom_component / pull_custom_component / publish_custom_component：生成 cc plugin ... 命令
• 客户端脚本（Script）相关命令生成
  • pull_client_script / publish_client_script：生成 cc script ... 命令
• JSP 迁移（调用 cloudcc-cli 原 handler 的 node -e 命令）
  • analyze_jsp_migration：分析 JSP 迁移风险（生成 node 调用命令）
  • split_jsp_to_cloudcc：拆分/生成（支持 dry-run/apply 与 overwrite）

13. CloudCCDev 解码补全工具（src/tools/cloudccdev_expand_tools.py）

• expand_cloudcc_dev
  • 用途：解码并补全 CloudCC 开发配置（CloudCCDev expand）
  • 关键入参：safetyMark（缓存 key）、cloudccDev（base64 JSON 串）、overrides（可选覆盖字段）
  • 输出：补全后的配置 JSON；对解析失败有明确错误信息