TDuck MCP Tools 完整清单

TDuck MCP Server 面向 AI Agent（如 Claude、Cursor、Windsurf 等）提供了覆盖表单全生命周期管理的丰富工具集（Model Context Protocol Tools）。

AI 可以通过自然语言直接调用这些工具完成表单设计、题目编排、主题美化、逻辑跳题、数据录入、数据分析与查询等全流程操作。

---

📋 工具分类概览 (共 30 个 Tools)

mindmap
  root((TDuck MCP Tools))
    账号身份
      get_current_user
    表单生命周期
      list_forms
      get_form_detail
      create_form
      copy_form
      update_form
      update_form_basic
      update_form_theme
      update_form_setting
      replace_form_items
      publish_form
      stop_form
      delete_form
    逻辑与计算公式
      get_form_logic
      update_form_logic
    单题精细维护
      list_form_items
      add_form_item
      update_form_item
      delete_form_item
    文件夹管理
      list_folders
      create_folder
      move_form_folder
    数据与填报
      query_form_data
      get_form_data_detail
      submit_form_data
      batch_submit_form_data
      update_form_data
      delete_form_data
    数据安全检查
      check_field_data
    文件与图片直传
      get_upload_ticket
      upload_file
    公开自助查询
      list_opensearch_queries
      get_opensearch_query
      create_opensearch_query
      edit_opensearch_query

---

👤 1. 账号与身份信息

工具名称 (Tool Name)	功能描述	核心入参
get_current_user	获取当前登录账号的完整身份信息（包括用户ID、账号、昵称、手机号、邮箱、所属部门、角色、岗位及管理员状态等）。	无

---

📑 2. 表单生命周期与整体管理

工具名称 (Tool Name)	功能描述	核心入参
list_forms	查询当前用户的表单列表，支持按关键字搜索、收集状态与分页	keyword (关键字), status (RELEASE/STOP), folderId (文件夹ID), current (页码), size (每页条数)
get_form_detail	根据 formKey 获取表单完整的扁平题目结构、选项、主题外观与行为设置	formKey (表单唯一Key，必填)
create_form	快速创建全新表单或在线考试（极简扁平模型）	name (表单名), description (说明), type (NORMAL普通/EXAM考试), items (题目定义列表)
copy_form	复制已有表单的题目、设置与主题外观生成新表单	formKey (源表单Key，必填), name (新表单名), folderId (目标文件夹ID)
update_form	复合更新表单基础信息、题目、主题外观或全局防刷/提交设置	formKey (必填), name, status, items, theme, setting, logic
update_form_basic	仅修改表单的基础信息（名称与描述说明）	formKey (必填), name (表单名称), description (表单描述)
update_form_theme	专门更新表单的主题视觉样式（配色、背景色/图、Logo、头图、按钮文字、封面页、水印等）	formKey (必填), theme (主题样式配置对象)
update_form_setting	专门更新表单的全局收集与行为设置（登录限制、白名单、IP限额、开放时间范围、提交后跳转、邮件微信数据提醒、考试防作弊等）	formKey (必填), setting (行为规则配置对象)
replace_form_items	全量覆盖并重置指定表单的题目列表（旧题目将被物理清理并重构）	formKey (必填), items (全新题目定义数组)
publish_form	发布表单开启数据收集通道，锁定题目结构并返回公开填报链接	formKey (必填)
stop_form	停止表单收集，关闭对外公开填写通道	formKey (必填)
delete_form	逻辑删除指定表单及其关联的所有题目与数据	formKey (必填)

---

🔀 3. 显隐跳题逻辑与计算公式

工具名称 (Tool Name)	功能描述	核心入参
get_form_logic	查询指定表单当前配置的显隐跳题规则与联动计算公式	formKey (必填)
update_form_logic	更新表单的显隐跳题逻辑与计算公式 DSL 配置（支持条件判断与联动触发动作）	formKey (必填), rules (规则列表), formulaDsl (公式配置)

---

📝 4. 单题精细化维护

工具名称 (Tool Name)	功能描述	核心入参
list_form_items	获取指定表单的所有题目列表详情	formKey (必填)
add_form_item	在指定表单末尾追加一道新题目	formKey (必填), item (题目定义对象)
update_form_item	根据题目 ID 修改指定题目的标题、必填、选项列表或提示文案	formKey (必填), item (包含 id 的题目对象)
delete_form_item	从指定表单中删除某一道题目	formKey (必填), id (自定义题目ID)

---

📁 5. 文件夹归档管理

工具名称 (Tool Name)	功能描述	核心入参
list_folders	获取当前用户的所有一级文件夹列表	无
create_folder	创建新的表单归档一级文件夹	name (文件夹名称，必填)
move_form_folder	将表单移动到指定文件夹（folderId 为 0 表示移出到根目录）	formKey (必填), folderId (目标文件夹ID，必填)

---

📊 6. 表单数据回收与填报

工具名称 (Tool Name)	功能描述	核心入参
query_form_data	分页查询表单已收集的填报数据，字段自动映射为设计时的自定义题目 ID，支持关键字与时间范围检索	formKey (必填), keyword, beginDateTime, endDateTime, current, size
get_form_data_detail	根据数据唯一 dataId 查询单条填报数据的完整详细内容	formKey (必填), dataId (数据ID，必填)
submit_form_data	向指定表单新增录入一条数据，字段直接使用设计时的题目 ID（如 q_name, q_gender）	formKey (必填), data (键值字典数据，必填)
batch_submit_form_data	批量向表单写入多条填报数据（单次最多支持 100 条）	formKey (必填), list (数据数组，必填)
update_form_data	根据 dataId 修改单条已提交的数据内容	formKey (必填), dataId (必填), data (修改键值字典)
delete_form_data	根据 dataId 删除指定的单条填报数据	formKey (必填), dataId (数据ID，必填)

---

🛡️ 7. 数据安全防护

工具名称 (Tool Name)	功能描述	核心入参
check_field_data	在删除或修改表单题目/选项前，检查该题目或选项是否已有用户历史填报数据，防止误删历史有效数据	formKey (必填), formItemId (题目ID), optionId (选项ID，可选)

---

📤 8. 文件与图片上传通道

工具名称 (Tool Name)	功能描述	核心入参
get_upload_ticket	【推荐 · 本地上传唯一通道】 获取本地文件/图片直传的预签名凭证 (Upload Ticket) 及极简 curl 执行命令。AI 在本地生成图片后获取凭证并在本地终端执行直传，直接换取公网 fileUrl，彻底避免大文件 Base64 导致的 Token 截断。	fileName (文件名), fileType (文件类型/后缀)
upload_file	转存网络图片链接为表单持久化附件并换取公网 URL（仅用于公网图片 URL 抓取转存）	url (公网可访问的网络图片地址，必填)

---

🔍 9. 公开自助查询页 (OpenSearch)

工具名称 (Tool Name)	功能描述	核心入参
list_opensearch_queries	查询表单对外公开自助查询页配置列表（供访客凭手机号/准考证号等自助查分/查数据）	formKey (必填)
get_opensearch_query	查询指定对外公开查询页的详细配置规则与字段展示范围	formKey (必填), queryId (查询配置ID)
create_opensearch_query	为表单创建对外公开查询页（设置凭证查询字段及允许查看的结果字段）	formKey (必填), name, queryConditionFields, resultShowFields, status 等
edit_opensearch_query	修改或启停指定表单的对外公开查询页配置	formKey (必填), id (查询配置ID，必填), name, status 等