技术手册 / MCP 指南 / 工具全景与「现查」方法

工具全景与「现查」方法

35-MCP 指南 · 2026-10-12 · 5.8 KB

本专题手工维护。⚠ 清单会漂 —— 本文是 2026-10-12 的实测快照（85 个工具），

永远以 tools/list（或应用内「MCP 接口手册」）现查为准。

分组口径来自应用内置的工具分组（与工具注册处双向校验 ⇒ 不漏不重 ✓）；界面上的权威入口是

帮助 →「MCP 接口手册」（按同一套分组实时展示 ✓）。

1. 三秒现查（推荐姿势）


# ① 只要数量与闸门状态（免鉴权）
curl -s http://127.0.0.1:<端口>/health
# ⇒ {"ok":true,"server":"unlimit-canvas-mcp","tools":85,"gated":false}

# ② 全量清单（要 token）
curl -s -X POST http://127.0.0.1:<端口>/mcp \
  -H "Authorization: Bearer $UNLIMIT_MCP_TOKEN" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

应用内更直观：帮助弹框 →「MCP 接口手册」（按功能族树状展示 + 调用示例）
⛔ 别拿任何离线文档当"某工具存在/某模板存在"的依据：工具看 tools/list，模板看 uc_do_sheet_templates（它自己是"模板是否存在的唯一真相"）

2. 工具全景（按功能族 · 快照 2026-10-12 · 共 85）

① 入门与总览

工具	作用
`uc_do_gain_agent_overview`	系统级指南：必学技巧 / 应用定位 / 核心概念 / 模板生态（带 `usage`）/ 操作规范 ⇒ 首次必调
`uc_do_health`	引擎健康检查（`comfyui` / `music3` / `api`）
`uc_do_gain_canvas_rules`	读画布范式规则并登记"已读"（写操作的前置）
`uc_do_suggest_prompt`	生成提示词首选：反推参考图 + 模板规范 ⇒ 分镜式提示词

② 模板与提示词

工具	作用
`uc_do_sheet_templates`	列全部模板（`enabled` / inputs / outputs / parameters）⇒ 模板存在性唯一真相
`uc_do_gain_template_guide`	单模板 Agent 指南（含"与相似模板的区别"）
`uc_do_gain_template_prompt_rules`	模板提示词规范（placeholder / 文本端口 / 参考端口 / `promptGuide`）
`uc_do_gain_hailuo_prompt_spec`	海螺分镜提示词规范（官方三段 Base / 六段 Ref2VA）
`uc_do_fix_hailuo_prompt`	把任意文本规整成海螺标准提示词并合规复检

③ 画布管理

工具	作用
`uc_do_new_canvas`	建空白画布（可归属项目容器 folder；Agent 沙箱 `owner=agent`）
`uc_do_sheet_canvases`	列出已保存画布（含 `folderId` / `canvasType` / 写入授权）
`uc_do_sheet_folders`	列出项目容器（folder：id / 名称 / 画布数）
`uc_do_gain_canvas`	画布摘要（节点列表 + 连线）
`uc_do_change_canvas_name`	改画布名
`uc_do_clear_canvas`	清空画布全部节点与连线（⛔ 不可恢复）
`uc_do_gain_canvas_globals`	读 `canvasGlobals` 与导演台计划（assets / shots / engines / ui）
`uc_do_write_canvas_globals`	写 `canvasGlobals`（浅合并；`director` 必须传完整对象）
`uc_do_gain_project_file`	读导演项目共享文件（大纲 / 故事 / 剧本 / 资产 / 台账）

④ 节点与参数

工具	作用
`uc_do_create_node`	建模板节点（不传坐标 ⇒ 自动网格排布）
`uc_do_gain_node`	单节点完整详情（参数 / 提示词 / 资产 / 状态 / 结果）
`uc_do_write_node_params`	写参数（按模板 `parameters` 校验；未知键报错）
`uc_do_write_node_prompt`	写主提示词 / 创作描述
`uc_do_connect_nodes`	连线（做端口类型校验）
`uc_do_kill_node`	删节点及其连线
`uc_do_update_node_position`	移动节点
`uc_do_update_node_label`	重命名节点
`uc_do_ensure_group`	取/建分组容器并把节点归入
`uc_do_gain_group_nodes`	列组内成员与产出（批量生成后看谁成了/谁失败）

⑤ 运行与任务

工具	作用
`uc_do_run_node`	运行节点 ⇒ `jobId`（全仓唯一「运行已有节点」入口）
`uc_do_gain_job_status`	查任务状态
`uc_do_wait_for_job`	阻塞等待（默认 300s、2s 轮询）
`uc_do_gain_node_result`	取节点最近产出（文件路径 / URL）
`uc_do_cancel_job`	取消运行中/排队任务
`uc_do_sheet_jobs`	列出运行中/排队任务

⑥ 媒体与素材

工具	作用
`uc_do_create_media_node`	建媒体产出节点（`mediaRole`/`mode`/`inputAssets` 直填免连线）
`uc_do_write_media_node_patch`	媒体节点白名单字段直写（params 深合并）
`uc_do_sheet_assets`	列本机媒体资产库（选材入口）
`uc_do_upload_asset`	上传本地文件成素材节点（或直接建文本节点）
`uc_do_analyze_image`	识别一张图并返回详细提示词描述
`uc_do_extract_frame`	抽一帧存 jpg（审片用）
`uc_do_inventory_media`	批量抽帧盘点素材（默认每视频 3 帧）

⑦ 导演台与蓝图

工具	作用
`uc_do_director_run`	导演台一键调度（逐镜建媒体节点并跑，含预检硬门）
`uc_do_gain_blueprint_spec`	蓝图（`.json`）/ director 完整书写规范
`uc_do_author_blueprint`	蓝图创作向导（自动组装 director 骨架）
`uc_do_author_blueprint_resources`	对未装载资产逐个生成并回填
`uc_do_gain_engine_manifest`	引擎/能力清单（含能力边界卡）
`uc_do_gain_capability_map`	能力地图（按意图检索该用哪些节点）
`uc_do_validate_blueprint`	蓝图写前结构校验
`uc_do_preflight_engine`	逐镜 dry-run 预检（硬规则 + 资产契约）
`uc_do_review_shots`	分镜内容审查（资产↔分镜↔引擎关系链）
`uc_do_save_blueprint` / `uc_do_load_blueprint`	画布 ↔ 蓝图文件

⑧ 海报与时间线

工具	作用
`uc_do_gain_poster_spec` / `uc_do_validate_poster`	海报设计文件协议规范 / 校验
`uc_do_preflight_poster`	海报渲染前本地预检 + 布局模拟
`uc_do_save_poster` / `uc_do_load_poster`	节点 ↔ `.poster.json`

⇒ 海报侧怎么用（协同边界（沙箱里哪些被拦）· 三套骨架怎么取 · 把海报口径沉淀成技能）⇒ 见《海报设计》专题 ✓

| uc_do_gain_timeline_spec / uc_do_validate_timeline | 时间线文件协议规范 / 校验（含预演丢弃清单） |

| uc_do_save_timeline / uc_do_load_timeline | 节点 ↔ .timeline.json |

⇒ 时间线侧怎么用（协同边界（沙箱里哪些被拦）· 工程档怎么复用当模板 · 把剪辑口径沉淀成技能）⇒ 见《视频编辑》专题 ✓

⑨ 自定义 API

工具	作用
`uc_do_gain_custom_api_presets`	预设库结构化参数规范（枚举 / 边界 / refMode）
`uc_do_preflight_custom_api`	既定发送本地预检 dry-run（零网络）
`uc_do_request_api_approval`	申请管理员授权运行 API 节点（弹桌面确认框）

⑩ 知识库

工具	作用
`uc_do_kb_search` / `uc_do_kb_get` / `uc_do_kb_sheet`	检索 / 取全文 / 列表统计
`uc_do_kb_skill_list` / `_get` / `_add` / `_edit` / `_del`	技能增删改查（删除缺省为停用，可复活）
`uc_do_kb_write`	⚠ 是"提工单"，不是写知识条目
`uc_do_kb_ticket_state` / `_review` / `_rate` / `_list`	工单状态 / 批阅 / 提降权 / 列表
`uc_do_kb_consolidate`	知识树一次整合

⑪ 助手协作

工具	作用
`uc_do_plan_write`	写会话内任务清单卡（3~8 步）
`uc_do_ask_user`	结构化提问（渲染成可点选项）
`uc_do_compact_context`	请求压缩本会话上下文
`uc_do_gen_once`	会话直出一次性生成通道（沙箱跑一次，需 `confirmed`）
`uc_do_save_text`	长文本落成真实文件并作为产物交付
`uc_do_dial_test`	AI 拨测（固定样本回归）
`uc_do_console_say`	向导演台控制台注入用户消息并触发应答

3. 旧名与别名

应用维护一张旧名 → 现役名的别名表（历史工具名仍可被识别）⇒ 老配置/老脚本里的名字通常还能用
但新写的东西一律用现役名（以帮助弹框「MCP 接口手册」/ tools/list 现查为准 ✓）

4. 纪律（⛔ 这几条最容易踩）

数量/清单不写死在别的文档里：任何"一共 N 个工具"都只是快照 ⇒ 用 tools/list 现查
模板看 uc_do_sheet_templates：⛔ 别用离线文档判断模板是否存在/是否可用
enabled=false 的模板不可用：创建节点前确认 enabled=true（用户可在"模板管理"里关模板）
写操作前置：先 uc_do_gain_canvas_rules（读规则并登记已读）⇒ 这是应用侧的硬要求

← 第三方应用挂载（逐类实操）调用规范（画布寻址 · 端口 · 参数 · 提示词） →

来源：E:/workbuddyProj/unlimitCanvas/ai_manual/mcp_guide/02-工具全景与现查方法.md