Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

像塑 MCP Plus

NPM · @MUQIAN/XIANGSU-MCP-PLUS

Unofficial macOS MCP for Douyin AR (像塑): assets, menus, AI combine, delivery. For learning only.

+3 this week 71 Trust /100

Last scanned (1 day ago)

Scores higher than 42% of npm servers

Category Design and Media

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 43 of 124 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability59
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 28227 tokens (~300/item across 94 items; 94 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management42
  • Stability check failed: the tool surface changed between 0.7.0 and 0.9.0: 0 tool removals, 1 breaking changes, 45 additions. See how to fix → Fail
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "object_remove" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 94 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 19 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 32 to 36.

  • 17 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 26 to 29.

  • 15 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 19 to 22.

  • 13 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 12 to 16.

  • 12 Nov 26 0
    • Security disclosure: unverified → fail ▼ functional
  • 11 Nov 26 0
    • Stability: 0.07 → fail ▼ security
    • Schema quality: 13609 → 28227 ▼ functional
    • Security disclosure: fail → unverified ▼ functional
    • Package version: 0.7.0 → 0.9.0 functional
  • 10 Nov 26 +1
    • Stability: unverified → 0.07 ▲ functional
  • 9 Nov 26 +26
    • Malware scan: unverified → pass ▲ security
    • Known CVEs: unverified → pass ▲ security
    • Dependency health: unverified → 0.83 ▲ functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/@muqian/xiangsu-mcp-plus@0.9.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 124 packages
Packages resolved 124
Stale 43
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 94 exposed · ~28,227 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
ai_combine_apply ~266

把一张 AI 工作流放进场景,等同 AI 效果窗口的「应用」(可撤销):编辑器编译工作流、把工作流文件上传到特效平台,再添加「AI 组合效果」对象(场景里没有 2D 前景时一并建「2D 前景」「2D 摄像机」)。不扣额度,不新建草稿;工作流生成过预览视频时一并上传供审核。效果组合节点没有输入连线等情况下编辑器会拒绝,返回 AI_COMBINE_APPLY_FAILED 和编辑器的提示原文(如「请先连接效果组合器」)。返回 added_objects(新对象名和 object_path)和 draft_id(工作流已存成云端草稿时才有,否则为 null)。之后 save_project。

NameTypeReqDescription
graph_idstringyesai_combine_new 或官方 get_workflow_context 返回的 ai_graph_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

ai_combine_new ~257

新建一张「AI 组合效果」工作流(用户拍照后在云端按工作流出图或出视频),等同 AI 效果窗口的「新建工作流」:在本地建 AI Graph,只有「输入图」和「效果组合」两个节点且未连线;不联网、不扣额度、不建云端草稿。返回 ai_graph_id 和各节点的 node_id,交给官方 get_workflow_context / get_workflow_capabilities / apply_workflow_patch 添加生图节点、写 prompt、连线(官方 apply_workflow_patch 每次改完会把工作流保存成账号下的云端 AI 效果草稿),要看效果用官方 generate_workflow(扣额度)。改好后用 ai_combine_apply 放进场景。「添加对象」菜单里的 AI 组合效果只建空壳,不要用 menu_add。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

ai3d_animation_submit ~360

素材库「AI 3D › 3D动画」:把参考视频里人的动作做成动画,套到一个带标准人形骨骼的 FBX 上,返回 task_id。model 可选内置的 whole / upper_body / lower_body / arm(全身 / 上半身 / 下半身 / 手臂,编辑器自带的人形模型),或一个本地 .fbx 的绝对路径:须有骨骼(Hips、Spine、LeftUpLeg 等 20 根标准人形骨骼,名字完全一致、不带 mixamorig_ 前缀,缺了编辑器也只提醒,返回里会有 warning),骨骼和面数不超过编辑器的导入上限。参考视频须是 MP4、不超过 30 秒、20 MB、长宽不超过 1280,建议单人、全身出镜。图生 3D(ai3d_image_submit)出来的模型没有骨骼,不能直接用作 model。之后 ai3d_tasks 等完成、ai3d_import 导入(导入的是带动画的 FBX)。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
modelstring–whole / upper_body / lower_body / arm 之一,或本地 .fbx 的绝对路径;默认 whole。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
video_pathstringyes参考视频的绝对路径。

No output schema declared.

No examples provided.

ai3d_cancel ~103

取消一个还在 running 的 AI 3D 生成任务(等同面板里的「取消生成」)。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstringyes要取消的 task_id。

No output schema declared.

No examples provided.

ai3d_gs_segment ~347

素材库「AI 3D › 高精度模型重建」第一步:上传一段实物 360 度环绕视频,云端识别出要重建的主体,返回 seg_task_id 和主体图 subject_image_ref(交给 image_view 看)。确认主体没问题后用 ai3d_gs_submit 正式生成 3D 高斯点云(.ply);主体不对就换视频或重拍。视频须是 MP4 / MOV、不超过 120 秒、100 MB、长宽不超过 4000,主体清晰、光线充足、各角度都拍到。识别一般约 20 秒,最多等 wait_s 秒,超时编辑器会取消这次识别。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
video_pathstringyes环绕视频的绝对路径。
wait_sinteger–最多等待识别的秒数,默认 120。

No output schema declared.

No examples provided.

ai3d_gs_submit ~163

素材库「AI 3D › 高精度模型重建」第二步:按 ai3d_gs_segment 识别出的主体正式生成 3D 高斯点云,等同识别窗口里的「确认主体」,返回 task_id。之后 ai3d_tasks(kind=gs)等完成、ai3d_import 导入。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
seg_task_idstringyesai3d_gs_segment 返回的 seg_task_id。

No output schema declared.

No examples provided.

ai3d_image_submit ~302

素材库「AI 3D › 3D模型」(图生 3D):上传一张参考图,在云端生成 3D 模型(静态网格,没有骨骼和动画),返回 task_id。参考图须是 PNG / JPG / JPEG、不超过 10 MB、长宽不超过 4000 像素;主体完整清晰、无遮挡,背景尽量纯色(编辑器的建议)。卡通角色可以先用官方 generate_image 出一张正面全身、纯色背景的图再交给本工具。同一类型最多同时跑 3 个任务。之后用 ai3d_tasks(带 task_id 和 wait_s)等它完成,再用 ai3d_import 放进工程。是否扣账号额度以编辑器为准,编辑器代码里没有相关提示。

NameTypeReqDescription
image_pathstringyes参考图的绝对路径。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
precisionstring–精度(面数):low=1000、medium=10000、high=50000,对应编辑器的低 / 中 / 高面数;默认 medium。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

ai3d_import ~257

把一个已完成的 AI 3D 任务结果下载到编辑器的 AI 3D 缓存目录(面板里同样能看到),导入工程并放进场景(可撤销),与面板里勾选后点「导入素材」相同:图生 3D 导入 GLB(外层对象「模型大小控制」放大 15 倍)、3D 动画导入带动画的 FBX、高精度模型重建导入 PLY 点云(缩小到 0.3)。返回 added_objects(新对象名和 object_path)、package_folders 和本机预览文件。之后用 capture_preview 看大小和位置,save_project。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
kindstringyes任务类型,与提交时一致。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstringyesai3d_*_submit 或 ai3d_tasks 返回的 task_id。

No output schema declared.

No examples provided.

ai3d_tasks ~341

素材库「AI 3D」的生成任务(当前账号)。不传 task_id 时按 kind(必填)分页列出历史任务:状态(running / finished / failed)、创建和完成时间、输入(图生 3D 的精度、3D 动画的模型)、失败原因,以及结果是否已下载到本机和本机的预览图 / 预览视频(preview_image_file 交给 image_view 看)。传 task_id 时只查这一个(不用给 kind);再给 wait_s 就一直等到它不再是 running 或时间到(最多 600 秒),status=finished 后用 ai3d_import 导入。

NameTypeReqDescription
countinteger–每页数量,默认 20(服务端上限)。
cursorinteger–翻页游标,原样取上一页的 next_cursor。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
kindstring–列历史时必填:image=3D模型(图生 3D)、animation=3D动画、gs=高精度模型重建。只查一个 task_id 时不用给。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstring–只查这个任务(不用给 kind)。
wait_sinteger–配合 task_id:最多等多少秒,默认 0(只查一次)。

No output schema declared.

No examples provided.

ar_video_cancel ~153

取消一个还在 running(或 unconfirmed)的 AR 视频生成任务,等同面板里的「取消生成」。取消确认后任务从记录里消失(cancelled=true);取消前它已经结束时返回 cancelled=false 和结束时的 status。已经结束的任务(完成、失败、已取消)不能取消,直接报 AR_VIDEO_NOT_RUNNING。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstringyes要取消的 task_id。

No output schema declared.

No examples provided.

ar_video_import ~440

把一个 succeeded 的 AR 视频任务导入目标工程并放进场景,等同面板上勾选它后点「导入素材」(只导这一个,面板里其它勾选的结果不受影响):视频「混合透明.mp4」、它的视频纹理「混合透明 MP4 播放器」(Mp4Texture,.mp4Tex)和原声「原声.mp3」导入为工程资源;场景里建渲染组「AR跟踪」,其下「AR平面跟踪」(AR 平面,MeshRenderer)上挂「AR 视频主体 N」,以及「AR摄像机」;场景原来是空的时还会建「通用」组(摄像机和灯光)。「AR 视频主体」上:Image 的 texture 是那张视频纹理(播放由它负责,loopCount=-1 无限循环);AudioComponent 播原声;ARVideoAudioController(编辑器内置组件,参数 playOriginalAudio_target、originalVolume_target、videoTexture_target)让原声跟着视频播。脚本里控制播放:texture.getControl() 的 play() / pause() / resume() / stop(),事件用 APJS.EventManager.getObjectEmitter(texture) 监听 APJS.Mp4Event.PlayBegin / PlayEnd 等;可视化脚本用内置节点「视频纹理播放器」。返回 added_objects(新对象名和 object_path)、package_folders(这次导入新建的资源)和 plane_guid(编辑器选中的「AR平面跟踪」)。之后 capture_preview 看位置和大小,save_project。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstringyesar_video_submit / ar_video_tasks 返回的 task_id(须 status=succeeded)。

No output schema declared.

No examples provided.

ar_video_submit ~741

素材库「AI 素材 › AR 视频」(AR 视频贴片):提交一次生成,等同面板上的「立即生成」,云端(Seedance)接受任务后返回 task_id。编辑器没有单独的模式开关,由输入决定:mode=direct 只抠像、不改动作,主体须是视频,不能带 prompt 和参考素材;mode=motion 由 prompt(必填)描述新动作或样式,主体可以是图片或视频,可加参考图(如给主体加道具)和一段参考动作视频。输入先交给编辑器自己的素材检查和转换(与面板上传素材相同:只认 JPG / JPEG / PNG / MP4 / MOV,包括主体最多 9 张图、3 段视频,视频每段至少 2 秒、合计不超过编辑器开关给的上限,主体视频原长须小于 60 秒;不合规格的图片自动缩放压缩、视频自动转码裁剪,转不了时报 AR_VIDEO_INPUT_INVALID 并带编辑器原话),视频还要先过编辑器的内容审核(最长 15 分钟)。动作时长 duration_s 默认 10 秒,最短 4 秒,上限由编辑器开关决定(2026-11-08 为 15 秒,以 ar_video_tasks 返回的 limits 为准)。shadow 是「添加投影」,省略时用编辑器默认(开关 dyeh_enable_ar_video_shadow,2026-11-08 为开);开着时结果是带投影的幕底视频。同时最多 10 个任务在跑。会占用账号的 AI 模型使用次数(按特效师等级给),编辑器里查不到剩余次数和单次扣多少,用完时报「模型使用次数达到上限」。任务在哪个工程窗口提交,就在那个窗口里下载并合成结果,之后的 ar_video_tasks / ar_video_import 用同一个窗口最快;实测一段 10 秒的图片生成动作从提交到合成完约 6 分钟。

NameTypeReqDescription
duration_sinteger–输出动作时长(秒),默认 10,范围见 ar_video_tasks 返回的 limits。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
modestringyesdirect:主体视频直接生成 AR 视频贴片,只抠像不改动作;motion:按 prompt 和参考素材生成新动作。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
promptstring–动作描述(最多 2000 字),mode=motion 时必填,mode=direct 时不能给。任务文档的建议:写上「生成高清视频」这类话会出高清。
reference_imagesarray–参考图的绝对路径(JPG / JPEG / PNG),如给主体加道具;仅 mode=motion。
reference_videostring–参考动作视频的绝对路径(MP4 / MOV),动作迁移用;仅 mode=motion。
shadowboolean–「添加投影」,省略时用编辑器默认;前置自拍类效果一般关掉。
subjectstringyes主体图片或视频的绝对路径(面板文案「上传图片或视频」)。

No output schema declared.

No examples provided.

ar_video_tasks ~426

素材库「AR 视频」的生成任务(当前账号,与面板右侧的生成记录同一份)。不传 task_id 时按 offset / count 分页列出,最新的在前,并带上当前的输入限制 limits;传 task_id 时只查这一个,再给 wait_s 就一直等到它合成完、失败或时间到(最多 600 秒)。status:running 云端生成中、restoring 云端已完成,正在本机下载并合成、succeeded 可以导入、failed 失败(failure 里是编辑器给的原因和错误码)、unconfirmed 暂时查不到云端状态。每条带 name(工具栏后台任务里显示的名字)、mode、主体类型、参考素材类型、prompt、时长、投影;succeeded 的另有实际时长 seconds、尺寸、是否幕底 green_screen、原声 audio、本机的预览视频 preview_video_file(抠像后叠在 #1b1b1b 背景上)、要导入的视频 video_file,以及一张横排 6 帧的预览图 preview_image_file(交给 image_view 看动作,不用打开视频)。在别的窗口提交的任务,这个窗口第一次看到时要自己下载并合成,会先显示 restoring。

NameTypeReqDescription
countinteger–每页数量,默认 20。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstring–只查这个任务(ar_video_submit 返回的 task_id)。
wait_sinteger–配合 task_id:最多等多少秒,默认 0(只查一次)。

No output schema declared.

No examples provided.

baidu_hot_list ~209

百度热搜榜(top.baidu.com,不用登录、不用开像塑):置顶条 pinned 和 50 条热搜,按 offset / count 分页(默认前 20 条),每条有名次、词、摘要、热度、配图 image_ref、链接 link,榜单更新时间 updated_at。看站外正在发生的社会、娱乐话题。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。

No output schema declared.

No examples provided.

bilibili_hot_search ~45

B 站搜索框下的热搜词(不用登录、不用开像塑):名次、关键词、展示名、热度分,更新时间 updated_at。

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

bilibili_popular ~213

B 站「热门」视频(不用登录、不用开像塑):标题、BV 号、链接、封面 cover_ref、分区、UP 主、播放 / 点赞 / 评论 / 弹幕数、时长、发布时间、上热门的理由(如「百万播放」)。按 page 翻页。看年轻人在 B 站追的梗和内容。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20(最大 50)。
pageinteger–页码,默认 1,取上一页的 next_page。

No output schema declared.

No examples provided.

douyin_hot_detail ~204

一个抖音实时热点的详情(像塑移动版「热点详情」页同一接口):名称、分类、上榜时间 listed_at_text、站内已有的特效数 effects_text(如「上线特效0个,等级特效0个」,0 说明还没人做)、近 7 天每天的热度 days 和今天每小时的热度 hours(heat 数值、heat_text 页面文字)。hot_id 须来自本会话的 douyin_hot_list。服务端偶尔答「网络开小差了」,隔几秒再调。

NameTypeReqDescription
hot_idstringyesdouyin_hot_list 返回的 hot_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

douyin_hot_list ~204

抖音实时热点榜(像塑移动版「实时热点」同一接口,约 5 分钟一版):前 20 条的 hot_id、名次、名称、分类 categories(娱乐、站内玩法、话题互动、二次元等;「站内玩法」多是正在火的梗、手势舞和跟拍玩法)、热度文字。榜单版本时间 updated_at。看一个热点的热度走势和站内已有特效数用 douyin_hot_detail,看它的热门视频用 douyin_hot_videos。像塑官方挑过、适合做特效的话题见 rank_hotspots。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

douyin_hot_videos ~295

一个抖音实时热点下的视频(像塑移动版「热点详情」页同一接口,按接口原样的顺序,不是按热度排的,点赞常常只有几十):视频 ID、播放地址 video_ref、封面 cover_ref、点赞数、作者昵称,按 offset / count 分页。用来看这个梗、玩法实际怎么拍。hot_id 须来自本会话的 douyin_hot_list。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
hot_idstringyesdouyin_hot_list 返回的 hot_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

effect_check ~303

特效检测,和在编辑器工具栏点「特效检测」一样:打开「特效检测」窗口,由窗口把特效包上传到抖音做云端检测(不是发布),等待结果 passed / not_passed / needs_optimization / failed。出结果后读出检测页的详情一起返回:verdict(页面结论,如「检测通过」「特效不通过」)、checks(每项检测的结论;包体积、帧率给出 figures:数值、上限、是否达标,帧率分 android / ios;没通过的项带页面给的改进建议 advice,读不到时写 advice_unavailable),然后关掉这个窗口(window_closed=true);详情读不出来时窗口留着,返回 details_error。超过 timeout_ms 还没出结果时返回 timeout,窗口留着继续检测;之前调用留下的检测窗口会先关掉再开新的(closed_previous 是关掉的个数),所以窗口不会越叠越多。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
timeout_msinteger–最长等待时间,默认 300000(5 分钟)。

No output schema declared.

No examples provided.

effect_detail ~449

任意一个已上线特效或模板的详情(像塑移动版「发现」页特效详情同一接口,别人的特效也能看):名称、类型(特效 / 模板)、effect_id、上线时间、等级代码 level_code、累计投稿 / 点赞 / 评论(页面原样文字)、年轻 / 男生喜爱度、热玩分、男女投稿比例、受众(年龄、性别)、风格(如潮酷)、平台判定的类型 category(如「社交测试」「美妆」)、来自哪个工具、流量状态、用到的编辑器能力 functions(如美瞳、屏幕液化、3D 模型动画、辉光、滤镜,看出爆款怎么组合)、作者及等级、图标 icon_ref、几条示例视频(video_ref 和封面 cover_ref)。category、functions、designer、点赞评论数这几块服务端有时不返回(同一个特效连查也会时有时无),缺的给 null,隔一会儿再查;读不懂的字段原样放 unread。用这个特效拍的视频(标题、跟拍数)用 effect_videos,工程用 works_by_effect。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
app_effect_idstringyes特效在抖音上的 ID:rank_list、rank_subject_detail、rank_innovation、effect_search、my_effects 返回的 app_effect_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

effect_search ~421

按关键词搜索像塑全平台已上线的特效或模板(像塑移动版搜索页同一接口):effect_id、app_effect_id、名称、说明、等级代码、年轻喜爱度、累计投稿(页面原样文字)、图标 icon_ref。特效最多翻到 100 条。按 cursor 翻页,每页最多 20 条。顺序是服务端定的,前几名多是累计投稿很高的老特效;接口不认排序参数(2026-11-09 试了 sort_type、order_by、sort 等 12 种写法,顺序都不变),要看现在火的用 rank_list / rank_subjects。只搜首页工程用 works_search;拿到特效后用 effect_detail 看详情、effect_videos 看视频、works_by_effect 找工程。搜灵感用 inspiration_search,搜教程用 tutorial_search。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20(最大 20,更多服务端报错)。
cursorinteger–翻页游标,取上一页的 next_cursor。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
kindstring–effect 特效(默认),template 模板。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
querystringyes关键词,如「美妆」「测一测」「变装」。

No output schema declared.

No examples provided.

effect_videos ~305

用一个特效拍的抖音视频(像塑移动版「作品详情」页的视频卡片,别人的特效也能看):累计点赞和跟拍(页面原样文字),以及几条热门视频 videos(实测 5 条):抖音视频 ID item_id、标题、作者、点赞、跟拍、封面 cover_ref 和视频 video_ref(交给 image_view 拿地址)。看别人怎么拍、文案怎么写。自己刚上线、还没人拍的特效列表是空的。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
app_effect_idstringyes同一个特效的 app_effect_id。
effect_idstringyes特效 ID(rank_list、effect_search、my_effects 等返回的 effect_id)。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

ext_status ~147

扩展自身状态:官方 MCP 连接情况;本次启动时编辑器插件的安装结果 plugin_install(action 为 installed 新装、kept 已有同版本或更新的插件未动、failed 安装失败附 error);以及每个已加载 XiangsuMcpExt 插件的工程窗口(pid、工程路径、对应的官方 instance_id、有没有未保存的改动 unsaved_changes(读不到时为 null)、编辑器接口自检)。工具报找不到窗口、INCOMPATIBLE_EDITOR 或官方工具不可用时先调它排查;插件只在装好后新打开的工程窗口里生效。

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

face_warp_list ~135

列出场景里所有「塑型画笔」组件(FaceWarpX,含猫脸/狗脸),返回 object_path、是否启用、每项画笔的序号与强度。官方 edit_by_dsl 的 set_component 命令改不了画笔强度,用 face_warp_set_intensity。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

face_warp_set_intensity ~197

修改「塑型画笔」强度(等同检查器强度滑块,0–100),只改强度、保留笔刷数据,可撤销。object_path 取 face_warp_list 的路径,或能唯一定位的末尾几段。省略 item_index 时改全部画笔项。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
intensitynumberyes强度,0–100。
item_indexinteger–只改某一项画笔;省略时改全部。
object_pathstringyesface_warp_list 返回的 object_path,或能唯一定位的末尾几段。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

growth_route ~209

像塑移动版的「成长之路」:当前账号的特效师等级 current_level,以及每一级(新手特效师、潜力特效师……大师特效师)的现金奖励、状态(done 已完成 / in_progress 进行中 / locked 未解锁)和要达成的目标:每个目标的说明(如「绑定「灵感」上线 0/3 个作品」)、当前进度 current / 目标 target、对应奖励。最高级给的是权益 rights。任意一个工程窗口开着即可,用编辑器里登录的账号读取。活动中心里一个个带参考工程和教程的成长任务用 growth_tasks_list。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

growth_task_detail ~202

一个成长任务的详情:标题、奖励、标签、参考工程、相关灵感(封面 cover_ref)和教程。task_id 须来自本会话的 growth_tasks_list。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
task_idstringyesgrowth_tasks_list 返回的 task_id。

No output schema declared.

No examples provided.

growth_tasks_list ~249

按 offset / count 分页列出活动中心里的成长任务:task_id、标题、奖励金额 bonus_yuan、标签、是否新手任务、参考工程。详情(参考工程、相关灵感、教程)用 growth_task_detail;特效师等级和每级目标进度在 growth_route。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

hotspot_inspiration_images ~358

把一个热点下全部灵感的图片下载到本机:逐条读灵感详情,下载详情里的全部图片(封面就是第一张;多数灵感只有 1 张,也有 3 张、6 张的),同一灵感在几个页签里出现只下一次。文件名是「序号-灵感标题-第几张.扩展名」,序号按热点页的顺序;同目录的 index.json 记下每条灵感的 inspiration_id、标题、页签、文件名和原图地址。文件是临时的:存在临时目录里,24 小时后删除(MCP 服务一直开着时到点删;服务重启过的,下次调用本工具时删),要留存就自己复制走。一个热点约 70 张图,一般一分钟左右。返回目录 dir、灵感数、存下的图片数、每条灵感的文件名,以及失败的灵感和原因 failed(详情读不出、图片下载两次都失败或不是图片);一张都没存下时报错。topic_id 来自 rank_hotspots。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
tabstring–只下这个页签的灵感(hotspot_inspirations 返回的 tabs 之一);省略时下全部。
topic_idstringyesrank_hotspots 返回的 topic_id。

No output schema declared.

No examples provided.

hotspot_inspirations ~281

一个热点下的灵感,按热点页页签的顺序、按 offset / count 分页:每条的页签 tab、inspiration_id、标题、标签、说明、封面 cover_ref(交给 image_view 看);tabs 是全部页签名。详情用 inspiration_detail;把这个热点下全部灵感的图片下载到本机用 hotspot_inspiration_images。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
topic_idstringyesrank_hotspots 返回的 topic_id。

No output schema declared.

No examples provided.

icon_open ~96

打开编辑器的「图标制作」窗口(官方图标模板、文字模板、AI 图标),让用户在里面挑选或调整。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

icon_set ~281

设置特效图标(提交特效必需):把一张图片居中裁成正方形、缩放到 360×360 PNG,写进工程的 Icon/ 目录(与「图标制作」窗口保存的同一批文件),并和那个窗口的「完成」按钮一样把图标上传到抖音特效平台(提交窗口只认上传过的图标)。默认女性、男性两个图标位都用这张图(提交窗口要这两个)。上传失败报 ICON_UPLOAD_FAILED,重试即可。图片可以来自 generate_image 生成的资源,或 capture_preview 截图另存的文件。之后 save_project 落盘。

NameTypeReqDescription
image_pathstringyes图片的绝对路径(png / jpg / webp 等 sips 能读的格式)。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
typestring–写哪个图标位:both(默认,女性和男性两个位都用这张图,提交窗口要的就是这两个)、female、male,或 common 通用。

No output schema declared.

No examples provided.

image_view ~226

查看图片。列表类工具(素材、作品、灵感、任务、排行榜、音乐等)返回的是短引用 *_ref / *_refs(如 img:12),详情类工具(inspiration_detail 的 images、menu_list details 的 image_url)返回地址,都放进参数 images(数组,如 images: ["img:12", "https://…"];没有 ref / refs / url 参数);也可以传本机图片文件的绝对路径(如 menu_list details 的 image_file)。视频和音频引用(video:3、audio:5)看不了画面,返回它的原地址。一次最多 8 张,只认 png / jpeg / gif / webp,单张失败只在该项写明原因;图片很大(如动图)时一次给不完,没给的列在 not_returned 里,再调用一次即可。

NameTypeReqDescription
imagesarrayyes其它工具返回的引用(img:12)、http(s) 图片地址,或本机图片文件的绝对路径。

No output schema declared.

No examples provided.

inspect_many ~794

一次查看多个对象的组件参数(逐个调用官方 inspect;只看一个对象的完整原始数据时直接用 inspect),值里的 {type, data} 包装直接展开成值,超长数组只给长度和前几项;绑定的资源写成 {resource, type, file},引用的对象写成 {object, name}。component_types 只留某些组件(如 ["Transform"]),fields 只留属性名包含这些片段的属性(不分大小写,如 ["intensity", "position"])。fields 也会留下内部某一层属性名包含这些片段的整块参数(如后处理的 bloom 块里的 pBloomThreshold)。妆容层(FaceMask / FaceMaskDY)的混合模式编号旁边加上 blendMode_name / surfaceBlendMode_name(如「正片叠底」)。preset="key" 自动留下通常决定效果的参数:位置/缩放/旋转、显隐与启用、强度/不透明度/Transparency/权重/颜色类属性、AI 脸的 Channel(Texture 皮肤路 / Distortion 形变路)、内部含强度类参数的整块参数(如后处理的发光、调色)、文字内容(str)与 2D 尺寸(sizeDelta)、绑定的资源,以及场景文件里脚本组件的全部参数;空的贴图槽(编辑器的「缺失纹理」)和完全透明的黑色(妆容层没用到的珠光色等)会丢掉(这份清单是按已做过的妆容、形变、贴纸、文字效果拍的,缺的用 fields 补,可与 fields 同时用;fields 点名的属性即使空着也留下)。guids 里每一项可以是 guid、对象名称或层级路径(同 scene_tree 的 subtree:从渲染组名起,或只给末尾几段;重名时该项报 AMBIGUOUS_OBJECT 并列出候选);不是场景对象的 guid(组件、资源)原样交给官方 inspect。传 project_dir 时不开窗口、直接读场景文件(含编辑器面板里的参数,如妆容的贴图和强度),guid 是 scene_tree 给出的 #序号;内置资源写成 {builtin: id},组件运行时生成、工程里没有文件的资源写成 {path}。单个对象失败只在该项写明原因。save_to 是目录的绝对路径,结果另存为其中的 inspect_many.json,长期保留。

NameTypeReqDescription
component_typesarray–只保留这些类型的组件。
fieldsarray–只保留属性名包含这些片段的属性。
guidsarrayyes要看的对象:guid(scene_tree / get_scene 返回的;project_dir 时是 #序号)、名称或层级路径;开窗口时也可以是组件或资源的 guid。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
presetstring–key:只留关键参数,见工具说明。
project_dirstring–不开窗口、直接读这个工程目录的场景文件;给了它就不看 project_path / instance_id。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
save_tostring–另存到这个目录(绝对路径,不存在会创建),长期保留。

No output schema declared.

No examples provided.

inspiration_bind ~208

按 inspiration_id 把一条创作灵感绑定到当前工程(编辑器给 agent 的同一接口),之后 save_project 落盘,打开提交窗口时会自动带出。提交窗口的下拉只列已收藏的灵感,没收藏的会带不出来,所以本工具会顺手收藏它(newly_collected=true 表示这次收藏的,不要了可用 inspiration_collect 取消)。只在提交时选灵感的话,也可以直接给 submit_prepare 传 inspiration:它在提交窗口的下拉里按名称选,只列当前账号收藏的灵感和热点。

NameTypeReqDescription
inspiration_idstringyes要绑定的 inspiration_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

inspiration_collect ~125

收藏或取消收藏一个灵感(写入当前登录账号,与灵感详情页的收藏按钮相同),之后重新查询收藏状态确认生效。

NameTypeReqDescription
collectboolean–true 收藏(默认),false 取消收藏。
inspiration_idstringyes要收藏的 inspiration_id。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

inspiration_collected ~344

分页列出当前账号收藏的灵感(和首页「灵感」页签里的「收藏」页同一接口),按收藏时间从新到旧:字段同 inspiration_list,另有收藏时间 collected_at、作品类型 artwork_type(0 特效、2 模板、5 表情)、所属征集任务 task(task_id 和标题;提交时选了别的任务,这条灵感会被挤掉)。服务端没给灵感卡片的条目只有 inspiration_id 和标题,并标 card_missing=true。只列灵感,不含收藏的热点和素材。submit_prepare 的 inspiration 按标题在这些收藏里选。按 cursor 翻页,total 是收藏总数。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20,最多 50。
cursorinteger–翻页游标(偏移量),取上一页的 next_cursor;默认 0。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

inspiration_detail ~272

一个灵感的详情:玩法说明、特效类型、激励说明、全部图片的地址 images(用 image_view 看)、作者、奖励(金额、说明、时间)、关联热点(热度和标签,如「66条热点相关灵感」)、关联官方工程 project(服务端只给标题、图标和「可在像塑桌面端搜索使用」,没有工程 id,2026-11-09 查了 13 个带工程的灵感都是这样;要下载就拿标题去 works_search)、已有的同灵感特效及发布量、示例视频 videos(抖音视频的播放地址 url、封面 cover_url、作者、点赞数、尺寸)、贴纸 stickers,以及当前账号是否已收藏和总收藏数。

NameTypeReqDescription
inspiration_idstringyesinspiration_list / inspiration_collected / inspiration_search / hotspot_inspirations / growth_task_detail 返回的 inspiration_id,或像塑 / 抖音 App 灵感页里的灵感 ID。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

inspiration_list ~321

分页列出某个分类下的灵感(灵感是官方和创作者发布的特效创意,首页右侧「灵感」页签就是它):inspiration_id、标题、标签(如「激励」)、作者、收藏数、是否已收藏、是否 AI 灵感、关联热点 hotspot、封面 cover_ref(交给 image_view 看)。每次都带上全部分类 tabs。拿到 inspiration_id 后用 inspiration_detail 看详情。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
cursorinteger–翻页游标,取上一页的 next_cursor。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
tabstring–分类名,取上次返回的 tabs 里的一个(全部、热门音源、头饰、变形等);省略时用第一个(全部)。

No output schema declared.

No examples provided.

inspiration_search ~254

按关键词搜索灵感(像塑移动版搜索页同一接口;inspiration_list 只能按分类翻):字段同 inspiration_list。按 cursor 翻页,每页最多 20 条。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20(最大 20,更多服务端报错)。
cursorinteger–翻页游标,取上一页的 next_cursor。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
querystringyes关键词,如「美妆」「测一测」「变装」。

No output schema declared.

No examples provided.

library_apply ~279

把一个官方素材应用到目标工程,与素材库面板里点应用相同(可撤销):素材包下载、校验 MD5、导入并默认放进场景;素材广场的卡片按 kind 走编辑器自己的应用流程(AI 图片、AI 妆容等只下载现成结果,不重新生成、不扣额度),等对象出现在场景里才返回。返回 kind、added_objects(新放进场景的对象名和 object_path)和 package_folders。template_id 须来自本会话的 library_list / library_search。应用后用 capture_preview 验收。

NameTypeReqDescription
auto_instantiateboolean–是否放进场景,默认 true;false 时只导入资源面板(只有 kind=package 支持)。
image_indexinteger–kind=ai_image 时用第几张结果图,默认 0;整组图见 library_images。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
template_idstringyeslibrary_list / library_search 返回的 template_id。

No output schema declared.

No examples provided.

library_images ~220

一张 AI 图片卡片(kind=ai_image)的整组结果图 image_ref,按 image_index 编号;用 image_view 看图,应用时用 library_apply 的 image_index 选择。template_id 须来自本会话的 library_list / library_search。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
template_idstringyeslibrary_list / library_search 返回的 template_id。

No output schema declared.

No examples provided.

library_list ~639

不传 panel_key 时列出可直接应用的分类面板(panel_key)和类型 kind:general 为普通面板(如 3d_distortion=脸部变形/3D 变形、distortion=美型、gaoguai_gan/makeup_gan=AI 实时变脸、3d_makeup=美妆、3d_filter=滤镜、sticker=跟脸贴纸);square 为 aigc_material=素材广场(其他创作者分享的素材,含现成的 AI 图片、AI 妆容、自定义实时变脸,应用时不重新生成、不扣额度);collection 为 collection=收藏(当前账号收藏的素材)。现生成的 AI 面板不在其中;其中「AI 3D」(图生 3D 模型、3D 动画、高精度模型重建)用 ai3d_* 工具,「AR 视频」(AR 视频贴片)用 ar_video_* 工具。传 panel_key 时分页列出该面板里的素材:子分类、素材(template_id、title、kind、封面 cover_ref 等)和翻页游标。素材广场的子分类是妆容、图片、实时变脸、跟脸贴纸、前景贴纸、画面特效、3D 模型、3D 饰品;收藏的子分类是全部、美妆、滤镜等目录。没有可应用内容的广场卡片不列出,只在 unsupported 里计数。按画面挑选时把 cover_ref 交给 image_view 看;知道要找什么时用 library_search 按关键词搜,本工具适合按面板和子分类浏览。拿到 template_id 后用 library_apply 应用,AI 图片卡片(kind=ai_image)的整组结果图用 library_images 取。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
category_idstring–子分类 ID(收藏为目录名);省略时用第一个子分类(通常是「全部」)。
countinteger–每页数量,默认 20。
cursor––翻页游标,原样取上一页的 next_cursor(收藏是字符串)。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
panel_keystring–面板,取不传 panel_key 时返回的 panels 里的 panel_key;省略时只返回面板清单。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

library_search ~684

按关键词搜索官方素材库(美妆、滤镜、脸部变形、AI 实时变脸、贴纸、画面特效、音效、素材广场等)。除了标题匹配,词正好是面板名或子分类名时也带出那里的素材:「滤镜」→ 滤镜面板,「腮红」→ 美妆/腮红、跟脸贴纸/腮红(这些素材标题里多半没有这个词),「复古滤镜」→ 滤镜/复古;每个面板或子分类最多 300 条。结果按标题完全相同 > 标题开头 > 标题包含 > 分类匹配 > 其余排序,每条的 matched 说明命中方式(title、category:面板/分类、panel:面板)。queries 一次搜多个近义词(最多 8 个)并合并去重。按 offset / count 分页(结果缓存 10 分钟,翻页不重新请求),每条带 template_id、title、panel_key、kind、cover_ref,另返回 total、by_panel(各面板条数,可再用 panel_key 缩小)、matched_categories(展开了哪些分类)、related_categories(名字里含这个词、没有展开的分类,可用 library_list 列出)。kind:package 素材包、ai_image AI 图片、ai_makeup AI 妆容、custom_gan 自定义实时变脸、foreground_sticker 前景贴纸、face_sticker 跟脸贴纸、filter 滤镜。第一页(没传 panel_key / offset)还会附带「添加对象」菜单里名字匹配的项到 menu_items(如「脸蛋天才」「磨皮」「发光」——它们不在素材库里,要用 menu_add 加),并写 menu_note。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。

NameTypeReqDescription
countinteger–每页数量,默认 20。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
offsetinteger–分页起点,取上一页的 next_offset;默认 0。
panel_keystring–只搜这个面板(library_list 不传 panel_key 时返回的 panel_key,如 aigc_material)。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
queriesarray–一次搜多个词并合并,如 ["冷艳", "猫眼", "烟熏", "风格妆"]。与 query 二选一。
querystring–搜索关键词,如「芒果脸」「腮红」「复古滤镜」。与 queries 二选一。

No output schema declared.

No examples provided.

makeup_compare ~918

在同一张脸上比较几种妆容状态:重置预览、播放 at_ms 后截基线(当前状态),再依次把每个 variant 的改动临时套上、等预览画出来、截一帧、改回去,最后再截一次基线。要用静态照片做的预览视频(如「模特D清秀||女」这些模特视频,每一帧都是同一张照片):会动的视频每次截到的是不同的帧,两次基线的平均亮度差超过 2 时返回提示。预览暂停后不再重绘,所以不能靠暂停停住画面。改动有两种,都实时生效、跑完改回原值:一是妆容层的 female / male(男女强度)和 intensity(面板上的「不透明度」,单独加的层实际画出的浓度是它 × 男女强度;整套美妆的子项由 AI 脸接管,改它不起作用)、美瞳和滤镜的 intensity;二是任意组件的一个数值属性:object_path + component(inspect 里的组件类型名,如 GanComponent、PostProcess)+ property(如 Transparency、bloom.pBloomIntensity)+ value,经官方 set_component 设置,用来比 AI 脸皮肤路强度、发光强度这类参数。换贴图、换混合模式要重载预览,不在这里比。整套妆的子项也可以这样调,强度改回原值,不会删层。regions 是按画面比例(0–1)给的区域,如眼下、脸颊、唇:每个区域返回每种状态的平均色 RGB / HSL、亮度 luma(Rec.601)、皮肤细节 detail(亮度减去 σ 2 px 高斯模糊后的平均绝对差,越高纹理越多),以及相对基线的差值;再给一张并排放大图(基线在最前,之后按 variants 顺序,像素直接放大不插值,一行放不下时换行)。给了 reference(参考图)时,区域的 ref 是同一部位在参考图上的框(按参考图的比例),每种状态另给 to_reference(相对参考图的差值),并排图最后一格是参考图的这一块(缩放到同样大小)。同一张静态照片上前后两帧在眼部的噪声约 0.5–0.8(平均,最大 13–18),差值比这个小的看不出区别。videos 依次在几个预览视频上各比一次,完了切回原视频。跑完所有改动都已改回;切换过视频或改过参数后工程会显示「已修改」。

NameTypeReqDescription
at_msinteger–重置后播放多久再截基线(毫秒),默认 3000(AI 变脸要过一会儿才完全生效)。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二���一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
referencestring–参考图(PNG / JPEG)的绝对路径;和区域的 ref 一起用。
regionsarrayyes区域:按画面比例给框(模特的眼睛位置各不相同,同一个比例框在别的模特脸上会框偏,换模特时按截图重新给框)。
save_tostring–另存到这个目录(绝对路径,不存在会创建),长期保留。
tracking_typestring–videos 所属的 tracking_type,默认 face。
variantsarrayyes–
videosarray–依次使用的预览视频名称(preview_videos 列出的 video_name);不给就用当前视频。
zoominteger–并排图的放大倍数,默认 3。

No output schema declared.

No examples provided.

makeup_layers ~689

列出一个工程的全部美妆层(FaceMask 妆容层、旧版 FaceMaskDY 妆容层和 EyeColorV2 美瞳),逐层说明画在哪个部位、什么颜色、男女强度,以及是否生效(对象或上级隐藏、组件停用、男女强度都为 0 的不生效)。区域(全脸 / 眼部 / 睫毛 / 唇部 / 牙齿)取自妆容层自身的类型;部位先看层名(眉、眼线、腮红、口红等关键字),层名看不出时按贴图像素判断(part_from 注明依据),颜色是贴图上色部分按透明度加权的平均色(color 和 hsl);层上设了着色 tint 时另给贴图色乘上着色的 tinted_color / tinted_hsl(按着色和贴图相乘算的,没有实测核对)。整张不透明的贴图(底色是白或黑、靠颜色深浅起作用)按每个像素离该混合模式下「不改变皮肤」的颜色多远来算颜色和范围,并在 texture_note 里注明;几乎全是这种中性色的层没有颜色,texture_note 说明它几乎不改变皮肤。texture_source 标出贴图从哪来:官方素材包(package_id 是这个包在素材库里的 template_id;整套美妆和部分素材包解压在按包名命名的文件夹里,这时给的是 package_folder,如「清冷_美妆」)、作者导入(file 是作者导入时的文件名)或未知,copy 为 true 表示是复制出来的副本(常是作者在官方贴图上改过)。FaceMask 的 intensity 是面板上的「不透明度」:单独加的层实际画出的浓度 opacity = intensity × 男女强度 × 外部强度;挂在整套美妆(AI 实时变脸)下的子项由 GAN 接管,改 intensity 不起作用,opacity 只按男女强度 × 外部强度算。FaceMaskDY 面板上只有一个强度(intensity),男女强度取它运行时各自的不透明度(实际渲染用的是这两个);它的唇部质地写成 surface(混合模式和强度)。groups 按眉、眼妆、美瞳、颊、轮廓、唇、点缀汇总生效的层,absent 列出整套妆里没有的部位,用来看一套妆缺了什么、或拆解别人的作品(works_download 下载的工程)用了哪些部位和颜色。读的是工程目录里的场景文件:正在编辑的工程先 save_project。

NameTypeReqDescription
project_dirstringyes工程目录的绝对路径(含 Assets/main.scene),如 works_download 返回的 project_path 或自己的工程。
save_tostring–另存到这个目录(绝对路径,不存在会创建),长期保留。

No output schema declared.

No examples provided.

menu_add ~131

按 menu_id 往场景添加一个官方功能对象,与在编辑器菜单里点选等效(可撤销)。kind=package 的项会先下载官方素材包再导入。返回 added_objects(新对象名和 object_path)。

NameTypeReqDescription
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
menu_idstringyesmenu_list 返回的 menu_id。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

menu_list ~397

列出像塑「添加对象」菜单里的全部官方功能项(工具栏美妆、美型、AI 实时变脸,及人脸/身体/2D/3D/AI 玩法/互动/宠物/音乐等),返回 menu_id、中文名、路径、类型。官方 edit_by_dsl 的 add_builtin_object 命令只覆盖其中一部分;美容(面部提拉、祛皱纹)、面部生成(烟熏妆、卡通脸)、表情生成(香肠嘴、呲牙尬笑)、性别年龄、五官处理、身体换装等用 menu_add。query 按名称、路径或 menu_id 过滤。details=true 时每项再带说明 description 和示意图(编辑器悬停提示里的图:在 CDN 上的给 image_url,随编辑器安装的给本机文件 image_file,都没有为 null),按画面挑选 AI 变脸、美容等效果时把它交给 image_view 看;details 一次最多 8 项,query 匹配更多时报错。云端 AI 生成项不在列表中;拍照后云端生图的「AI 组合效果」用 ai_combine_new / ai_combine_apply。

NameTypeReqDescription
detailsboolean–同时返回说明和示意图,默认 false;匹配项须不超过 8 个。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。
querystring–按中文名、路径或 menu_id 过滤,如「表情」「美容」「烟熏妆」。

No output schema declared.

No examples provided.

messages_list ~243

像塑移动版「消息」页的站内信,最新的在前:标题、正文、时间、是否已读、分组(服务 / 官方)、审核类消息的状态和对应的 effect_id、点开的链接 link。包括发布成功、进入测试、上线(「拍摄特效视频可获得更多冷启流量」)、审核未通过、精选审核中、任务完成、获奖公布、成长之路奖金到账等。按 cursor 翻页。

NameTypeReqDescription
countinteger–每页数量,默认 20(最大 50)。
cursorstring–翻页游标,原样取上一页的 next_cursor。
groupstring–all 全部(默认),service 服务(任务完成、获奖公布、精选审核等),official 官方(发布、审核、上线等)。
instance_idstring–官方 list_instances 返回的 instance_id,与 project_path 二选一。
project_pathstring–目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。

No output schema declared.

No examples provided.

Install

How do I install the 像塑 MCP Plus server?

像塑 MCP Plus runs locally as an npm package, launched with npx -y @muqian/xiangsu-mcp-plus. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @muqian/xiangsu-mcp-plus

# add to Claude Code
claude mcp add muqian-sun-xiangsu-mcp-plus -- npx -y @muqian/xiangsu-mcp-plus
Common questions

What is the 像塑 MCP Plus server?

像塑 MCP Plus is listed in the public MCP registry as io.github.Muqian-Sun/xiangsu-mcp-plus. Unofficial macOS MCP for Douyin AR (像塑): assets, menus, AI combine, delivery. For learning only. This page covers its npm package (@muqian/xiangsu-mcp-plus).

Is the 像塑 MCP Plus server safe to use?

像塑 MCP Plus scores 71 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the 像塑 MCP Plus server expose?

像塑 MCP Plus exposes 94 tools: ext_status, project_open, project_new, project_close, image_view, and 89 more. Their descriptions and schemas cost roughly 28,227 tokens of context every time the server is loaded.

Is the 像塑 MCP Plus server still maintained?

像塑 MCP Plus is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the 像塑 MCP Plus server under?

像塑 MCP Plus declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the 像塑 MCP Plus server?

VerifyMCP ran 16 checks on 像塑 MCP Plus, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.