像塑 MCP Plus
NPM · @MUQIAN/XIANGSU-MCP-PLUS
Unofficial macOS MCP for Douyin AR (像塑): assets, menus, AI combine, delivery. For learning only.
Available components
Last scanned (4 minutes ago)
Scores higher than 44% of npm servers
Category Design and Media
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
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 10 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
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 Management46
- 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
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 →
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.
- 22 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 42 to 46.
- 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
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 22 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 →
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 →
mobile_preview ~186
手机预览:按工具栏「手机预览」的方式打包当前工程并上传到抖音的预览服务,返回和编辑器弹出的一样的二维码图片(及其文本、有效期),用抖音 App 扫码即可在真机上看效果。二维码同时存成文件 qr_file,可直接给用户扫,不要另存到别处:到期(expires_at,一般 7 天)后自动删除。会把特效包上传到抖音服务器;内容审核不通过时报 MOBILE_PREVIEW_MODERATION_FAILED。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
music_apply ~217
把一首抖音音乐设为特效的音乐,和音乐库里点「使用」相同:下载音频进工程、写入音乐信息,并在场景里加入抖音音乐对象(再次使用会替换上一首)。start_sec / end_sec 截取片段,默认整首。music_id 须来自本会话的 music_list 或 music_search。之后 capture_preview 验收、save_project 落盘。
| Name | Type | Req | Description |
|---|---|---|---|
| end_sec | number | – | 片段结束(秒),默认整首时长。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| music_id | string | yes | music_list 或 music_search 返回的 music_id。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| start_sec | number | – | 片段开始(秒),默认 0。 |
No output schema declared.
No examples provided.
music_categories ~101
抖音音乐库的分类(像塑原创、推荐、抖音收藏、潮流心选等)的 code 和名称,交给 music_list 看分类里的歌。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
music_list ~283
抖音音乐库一个分类的一页(每页约 35 首,按 cursor 翻页):music_id、标题、作者、时长 duration_sec、封面 cover_ref、试听 preview_ref(音频引用)和 has_copyright(音乐库给的版权标记,false 或 null 的不要用于要发布的特效),以及下一页的 next_cursor、has_more。分类 code 从 music_categories 取;按关键词找歌用 music_search。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| category_code | string | yes | music_categories 返回的分类 code。 |
| cursor | number|string | – | 下一页:上一页返回的 next_cursor;省略时从第一页开始。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
music_search ~253
按关键词搜抖音音乐,一页约 35 首、按 cursor 翻页:每首的 music_id、标题、作者、时长 duration_sec、封面 cover_ref、试听 preview_ref(音频引用)和 has_copyright(false 或 null 的不要用于要发布的特效),以及 next_cursor、has_more。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | number|string | – | 下一页:上一页返回的 next_cursor;省略时从第一页开始。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| query | string | yes | 搜索关键词。 |
No output schema declared.
No examples provided.
my_effect_data ~373
一个自己已上线特效的数据卡片,与像塑移动版「作品详情」页同一组接口:名称、类型、各 App 上线情况 apps(抖音 app_id 184、抖音极速版 1164:上线状态、时间、投稿峰值和累计)、用到的功能 functions、标签;数据卡片 figures(页面原样的名称、值和文字:累计曝光、累计投稿、累计播放、累计跟拍、平台判定的特效类型如「技巧比拼」「玩法测试」、特效等级、跟拍等级、年轻喜爱度);流量状态 traffic(如「流量正常」);播放数 views(与任务页的播放数同源);绑定的任务和灵感 related。按天的趋势和投稿等级用 my_effect_trend,收益用 my_effect_revenue。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| app_effect_id | string | yes | my_effects 返回的同一个特效的 app_effect_id(抖音上的特效 ID)。 |
| effect_id | string | yes | my_effects 返回的 effect_id。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_effect_revenue ~183
一个自己已上线特效的收益明细(像塑移动版「作品详情」页同一接口):总收益、基础等级奖、年轻奖、跟拍奖、精选奖,每项的金额 amount(页面原样)、说明 note(如「暂未达到最低等级」「不符合精选标准」)和是否已解锁。
| Name | Type | Req | Description |
|---|---|---|---|
| app_effect_id | string | yes | my_effects 返回的同一个特效的 app_effect_id(抖音上的特效 ID)。 |
| effect_id | string | yes | my_effects 返回的 effect_id。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_effect_reviews ~171
一个自己的特效的审核记录,与像塑移动版「审核记录」页同一组接口:名称、当前状态、绑定的任务,reviews 为「上线审核」时间线(最新的在前,提交成功、审核中、审核未通过等,每条有时间、去掉标记的正文 text、分条原因 refuse_reasons、链接 links),innovation_reviews 为「精选审核」时间线(没有时为空)。
| Name | Type | Req | Description |
|---|---|---|---|
| effect_id | string | yes | my_effects 返回的 effect_id。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_effect_trend ~259
一个自己已上线特效的「数据趋势」和投稿等级(像塑移动版「作品详情」页同一接口):按天的曝光 exposure 和投稿 publish(逐日累计值,数据隔天才更新,当天为空),累计曝光���试拍 trial_total、跟拍、视频播放;投稿等级 level(当前等级代码 code、当前投稿 publish、下一级代码 next_code、升到下一级还差的投稿 publish_to_next)。等级代码和字母等级的对应没有接口给出,投稿门槛见像塑 App「激励规则」页。
| Name | Type | Req | Description |
|---|---|---|---|
| app_effect_id | string | yes | my_effects 返回的同一个特效的 app_effect_id(抖音上的特效 ID)。 |
| effect_id | string | yes | my_effects 返回的 effect_id。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| trend | string | – | 范围:recent 近 7 日(默认),since_online 上线后。 |
No output schema declared.
No examples provided.
my_effects ~410
当前登录账号提交过的特效,最新的在前(与像塑移动版「作品」同一个接口):effect_id、名称、审核状态 status 和 status_text(100 审核中、101 审核未通过、111 测试中、112 测试未通过、120 测试通过、103 已上线、104 已下线、113 延后上线、118 申诉重审中、119 申诉审核未通过)、提交和上线时间、绑定的任务 / 灵感 / 热点、能否编辑 / 删除 / 申诉及申诉类型、投稿量。101、112、119 的特效带 review:最近一条审核记录,text 是去掉标记的原因正文,refuse_reasons 是分条原因,links 是正文里的链接(如审核规则)。完整审核时间线用 my_effect_reviews;把 effect_id 和 app_effect_id 交给 my_effect_data(数据卡片)、my_effect_trend(按天趋势和投稿等级)、my_effect_revenue(收益)。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20(最大 50)。 |
| cursor | string | – | 翻页游标,原样取上一页的 next_cursor。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_profile ~183
当前账号的资料和数字,与像塑移动版「我的」页同一组接口:昵称、粉丝数、是否实名、特效作者 / 模板作者各自的等级 identities;数据卡片 figures(开拍总计、播放总计、本月提交、本月上线、本月收入、累计收入,页面原样的名称、值和文字);本月数据 month(本月上线数、本月收入、前一天收入、累计收入,其余字段含义未核实,原样放在 unread)。收益明细用 my_revenue。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_revenue ~121
当前账号的收益,与像塑移动版「钱包」同一接口:累计和某个月的总额、按来源(投稿收益等)的占比和金额、那个月每天的收入。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| month | string | – | 月份 YYYYMM,默认本月。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
my_task_status ~297
一次列出提交到所有已领取任务里的作品和它们的任务评定(逐个任务读任务详情页的「我的作品」,与 task_detail 的 my_effects 相同):每条带任务 task_id 和标题、作品名、effect_id、审核状态、拍摄 / 播放 / 投稿峰值、任务评定 task_state(pending 待评定、unfinished 任务未完成、done 任务已完成)和 off_theme(任务页标了「主题不符合」);summary 按评定计数并统计主题不符合的条数。没交过作品的任务不出现在列表里;每个已领取任务一次请求,按顺序发。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
object_remove ~344
删除一个场景对象(含子对象,可撤销),并找出只被它使用的工程资源:删除前后对比场景引用,删除前被引用、删除后不再被引用的即为孤儿(unused_paths 已合并到素材包文件夹,只含磁盘上存在的路径)。editor_only_paths 是素材放进场景时编辑器按对象名建的文件夹(如「复古清冷_滤镜」),只在编辑器里、尚未写到磁盘,对象删除后下次保存就会消失,不用删。delete_unused_resources=true 时一并删除 unused_paths(资源删除不可撤销);默认只报告,可之后用 resource_delete_unused 删除。object_path 用完整层级路径或能唯一定位的末尾几段(渲染组本身请用官方 edit_by_dsl 的 delete_render_group 命令)。只删对象、不关心资源时官方 edit_by_dsl 也能删;要知道删完哪些资源没人用了,用本工具。
| Name | Type | Req | Description |
|---|---|---|---|
| delete_unused_resources | boolean | – | 同时删除孤儿资源,默认 false(只报告)。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| object_path | string | yes | 对象的层级路径,如「面部拉伸/小屁桃_美型」,或能唯一定位的末尾几段。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
preview_frames ~510
按时间连续截取预览画面,分辨率是预览本身的(720×1280,官方截图是缩小后的 320×569),取自预览的渲染结果,窗口在后台或最小化时也能截(截图期间临时恢复正常帧率):默认先重置预览、等到重载后的画面出来,再每隔 interval_ms 截一张,共 count 张(一次最多 24 张),用来看动态效果、摇头时的侧脸等。videos 可依次换几个预览视频各截一组(名称取自 preview_videos,如 preview_single_shake_head||女),全部截完切回原视频,并等编辑器把视频写回工程信息,工程原来没有未保存的改动时,截完仍是干净的(note 里说明)。crop 按画面比例(0–1)裁出局部,如脸部。每帧都存成文件并随结果返回,files 里是路径,可直接贴给用户看;默认存在临时目录、24 小时后删除,save_to(目录的绝对路径)则存到那里长期保留。每帧注明实际截取时刻(相对重置完成的毫秒数)。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每个视频截几张,默认 4。 |
| crop | object | – | 裁剪区域,按画面宽高的比例,左上角为 (0, 0)。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| interval_ms | integer | – | 相邻两张的间隔(毫秒),默认 700。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| reset | boolean | – | 每组截图前先重置预览,默认 true。 |
| save_to | string | – | 另存到这个目录(绝对路径,不存在会创建),长期保留。 |
| tracking_type | string | – | videos 所属的 tracking_type,如 face、body、hand,默认 face。 |
| videos | array | – | 依次使用的预览视频名称(preview_videos 列出的 video_name);不给就用当前视频。 |
No output schema declared.
No examples provided.
preview_videos ~162
可用的预览视频名,按 tracking_type 分组(face、two_person、body、hand、pet、environment),外加当前视频 current:只给名字,用来挑 preview_frames、makeup_compare 的 videos 和官方 set_preview_video 的 video_name。要地址、有没有本地文件等全部字段用官方 list_preview_videos(约 70 KB)。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| tracking_type | string | – | 只列这一类,如 face;不给就全列。 |
No output schema declared.
No examples provided.
project_close ~124
关闭一个工程窗口(等同工具栏「回到首页」)。有未保存改动时默认拒绝,先 save_project;确实要丢弃改动才传 discard_changes=true。
| Name | Type | Req | Description |
|---|---|---|---|
| discard_changes | boolean | – | 丢弃未保存改动直接关闭。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
project_new ~66
新建一个空白像塑工程并首次保存到 path(目录须不存在或为空)。需要已有任意一个工程窗口开着。返回新窗口的 pid 和官方 instance_id。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | 新工程要保存到的文件夹绝对路径。 |
No output schema declared.
No examples provided.
project_open ~74
在新窗口打开一个已有的像塑工程(已经开着就直接返回)。返回窗口 pid 和官方 instance_id。旧版本工程可能弹出升级对话框,需要在编辑器里点确认。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | 工程文件夹的绝对路径(含 effect.dyehpj)。 |
No output schema declared.
No examples provided.
rank_creators ~226
创新计划的创作者月榜,按 offset / count 分页:名次、创作者 uid、昵称和头像 avatar_ref、上榜素材数、跟拍量、预计奖金(元)。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
rank_hotspots ~257
热点榜(按热度排序的抖音热点,每小时更新),按 offset / count 分页:名次、topic_id、标题、说明、热度、相关灵感数、封面 cover_ref。一个热点下的灵感用 hotspot_inspirations。抖音全站的实时热点榜见 douyin_hot_list。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
rank_innovation ~327
创新计划的官方精选(像塑移动版发现页的精选列表,移动版展示的是模板):特效名、effect_id、标签 labels(同一页里同一个特效带不同标签出现多次时合成一条)、投稿量、总收益、入选日期、封面。服务端的 offset 不按条目计,翻页时上一页的特效会再出现,返回的 date 也可能变;要全看时按 effect_id 去重。创作者月榜用 rank_creators。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20;精选由服务端过滤,实际条数可能略少。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| kind | string | – | template 精选模板(默认),effect 精选特效。 |
| offset | integer | – | 翻页偏移,取上一页的 next_offset。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
rank_list ~574
分页读取一个排行榜(与像塑移动版排行榜页同一个接口):名次、特效名、effect_id、等级、投稿量(峰值 / 累计)、跟拍量、男女比例、年轻喜爱度、热玩分、总收益等。可按日期、分类(每级一个,如只看「人像美化 › 美妆」)和筛选项过滤,每页都带上该榜当天的分类 categories(level 1 大类如人像美化、游戏玩法、人设扮演、AI 玩法,level 2 细类如基础头饰、测一测、不露脸壁纸;每个榜不同)。按主题的专题榜(如「热爆美妆特效榜」)见 rank_subjects。要看某个特效的工程,把 effect_id 和 name 交给 works_by_effect,查它在不在首页。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| categories | array | – | 分类名,取上一页返回的 categories,每级最多一个,可叠加,如 ["人像美化","美妆"](大类 + 细类)。 |
| count | integer | – | 每页数量,默认 20(最大 20)。 |
| cursor | integer | – | 翻页游标,取上一页的 next_cursor。 |
| date | string | – | 榜单日期 YYYY-MM-DD,默认最新一期。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| levels | array | – | 特效等级,如 ["S","A+"]。 |
| panels | array | – | 面板,如 ["头饰","美妆"]。 |
| preferences | array | – | 偏好。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| rank_type | integer | – | 榜单:1 年轻喜爱榜、2 特效每日投稿榜、3 男生喜爱榜、4 女生喜爱榜、7 热玩互动榜、9 模板每日投稿榜、10 特效跟拍榜;默认 1。 |
| tools | array | – | 来自工具。 |
| young_like_scores | array | – | 年轻喜爱度 1–10。 |
No output schema declared.
No examples provided.
rank_subject_detail ~200
「专题合集」里一个榜的全部特效(最多 20 个):特效名、effect_id、app_effect_id、图标、说明。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| subject_id | string | yes | rank_subjects 或 rank_subjects_search 返回的 subject_id。 |
No output schema declared.
No examples provided.
rank_subjects ~359
像塑移动版「专题合集」里按主题的榜单,最新的在前,按 cursor 翻页:kind=effect 为特效专题榜(近 200 期,如「测一测玩法特效榜 - 11月」「热爆美妆特效榜」「熊出没IP特效榜」「主题创新优胜特效榜」、各期征集活动优质特效),kind=template 为模板专题榜(如「歌词玩法模板榜」「AI配文创意模板榜」「氛围转场模板榜」)。每个榜带前几个特效、浏览量。按榜名搜用 rank_subjects_search,一个榜的全部特效用 rank_subject_detail。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20(最大 20)。 |
| cursor | integer | – | 翻页游标,取上一页的 next_cursor。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| kind | string | – | effect 特效专题榜(默认),template 模板专题榜。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
rank_subjects_search ~244
按榜名在「专题合集」的全部期里搜索(服务端没有搜索,逐页读完再过滤),返回全部匹配的榜,不分页;每个榜带前几个特效、浏览量。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| keyword | string | yes | 榜名里的词,如「美妆」「测一测」「IP」「热梗」。 |
| kind | string | – | effect 特效专题榜(默认),template 模板专题榜。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
resource_delete_unused ~123
删除 object_remove 报告的 unused_paths(工程内相对路径的资源或素材包文件夹)。删除前再次核对:当前场景仍在引用的一律拒绝。资源删除不可撤销。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| paths | array | yes | object_remove 返回的 unused_paths。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
scene_tree ~433
把场景结构输出成紧凑的缩进文本:渲染组,以及每个对象的 guid、名称、是否隐藏、组件类型。比官方 get_scene 的 JSON 好读,适合先摸清结构再用 inspect_many 查参数;要渲染组和对象的完整 JSON 用 get_scene。subtree 只看某个对象:guid、名称,或层级路径(从渲染组名起,或只给末尾几段,如「2D 前景/2D 摄像机」;同名对象常见,重名时报 AMBIGUOUS_OBJECT 并列出各自的 guid 和路径),depth 控制展开层数(默认 6);没展开的子对象会注明数量。传 project_dir(工程目录,如 works_download 下载的作品)时不需要打开窗口,直接读 Assets/main.scene 和 main.scene.extra,对象写成 #序号,组件类型和窗口里显示的一致(编辑器数据缺失时退回场景文件里的名称);没有渲染组这一层,渲染组本身作为根对象列出。save_to 是目录的绝对路径,结果另存为其中的 scene_tree.txt,长期保留。
| Name | Type | Req | Description |
|---|---|---|---|
| depth | integer | – | 展开层数,默认 6。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_dir | string | – | 不开窗口、直接读这个工程目录的场景文件;给了它就不看 project_path / instance_id。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| save_to | string | – | 另存到这个目录(绝对路径,不存在会创建),长期保留。 |
| subtree | string | – | 只输出这个对象及其子对象:guid(project_dir 时是 #序号)、名称或层级路径。 |
No output schema declared.
No examples provided.
shoot_activity ~223
当前账号本期的「拍视频激励」活动(像塑移动版首页活动卡片同一接口,按周重置):活动名、起止时间、本期拍摄数 shoot_count、收入 income(单位未核实,原样给)、本期任务 tasks(如「拍作品视频发布到抖音」「按照脚本拍摄同款视频」,各自的奖励文字、完成次数)、连续创作打卡 streaks(每档目标次数和奖金)、新手成长任务 newbie(每项的状态和页面文字、全部完成的奖金)、下次重置时间。状态码 status 的含义接口没给,原样给出,结合 text、finish_count 看。拍摄脚本用 shoot_scripts。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
shoot_scripts ~479
像塑官方的拍摄脚本(移动版「拍摄脚本」同一接口):教你用特效拍什么样的视频(如「【测一测】表演有梗结果」「【美妆】带特效前后反差」),每条有脚本 ID、名称、完整说明 description(脚本解读和「尝试拍一个」的具体做法)、标签代码 tags、播放数 views、拍摄数 shoots、封面 cover_ref 和示范视频 video_ref。tag 按标签代码筛选,App 里没有标签名,实测各代码下的脚本:1 测一测、2 游戏、3 美妆为主,含两条变形、4 变形为主,含一条美妆、5 AI、6 技巧。type 是接口给的脚本类型代码,含义也没给出(1 多为技巧合集,2 多为具体演绎)。全部约 50 条,按 offset / count 分页。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20(最大 50)。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| tag | integer | – | 标签代码(整数,写成 "3" 也行):1 测一测、2 游戏、3 美妆为主,含两条变形、4 变形为主,含一条美妆、5 AI、6 技巧;省略时全部。 |
No output schema declared.
No examples provided.
submit_close ~121
关掉这个工程窗口里开着的提交窗口(submit_prepare 打开、用户还没点提交的),不打开新的;返回关掉的个数 closed。要改填内容不用先关,直接再调 submit_prepare,它会先关掉旧的。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
submit_prepare ~737
填好提交窗口,停在最后一步等用户点「提交审核」:先在本地检查提交流程会拒收的情况(包体上限、是否原样套用模板、登录、图标),全部通过后先关掉还开着的提交窗口(之前调用留下的,closed_previous 是关掉的个数,关不掉报 WINDOW_NOT_CLOSED),再走和工具栏「提交特效」按钮相同的入口打开一个新的,然后逐页填写:「特效基础信息」页填名称、触发提示、默认摄像头方向(图标来自工程,可先用 icon_image 设好),「特效发布设置」页选灵感和任务,再翻到「提交审核」页,等页面上的检测(包体积、性能、相似度等,一般一分钟内)跑完,返回页面摘要、各检测结果、是否已同意创作者协议、「提交审核」按钮是否可点,以及 next(用户还要做什么)。本工具不会勾选协议,也不会点「提交审核」,发布只在用户点了之后发生。每一项都从页面读回核对:页面截断、报错、没选上、或翻页被拦住时直接报错(SUBMIT_*,原样带上页面提示),窗口保持打开。页面上本工具没填的其它设置(如活动、创新声明)列在 other_sections 里,保持页面原样。本地检查未通过时不打开窗口,返回 issues。
| Name | Type | Req | Description |
|---|---|---|---|
| camera | string | – | 默认摄像头方向:front 前置、back 后置;省略时保留页面的默认(一般是前置)。 |
| icon_image | string | – | 先用这张图设图标(同 icon_set 的默认:女性、男性两个位,并上传),再打开提交窗口;省略时用工程现有的图标。 |
| inspiration | string | – | 「灵感绑定」要选的灵感或热点,取它在列表里显示的名称(当前账号收藏的灵感或热点,灵感的名称同 inspiration_collected 的标题);传「暂不绑定」解绑;省略时保留页面带出的(inspiration_bind 绑定过的会自动带出)。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| name | string | yes | 特效名称(必填):最多 10 个字,两个英文字母或数字算一个字,不能有表情和特殊符号;页面截断或报错时整次调用失败。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| task | string | – | 「任务绑定」要选的任务标题(已领取的任务,同 tasks_list 的 title);传「暂不参与」解绑;省略时保留页面带出的(task_bind 绑定过的会自动带出)。 |
| task_track | string | – | 任务下的赛道名称,任务分赛道时必填,否则报 SUBMIT_TASK_NEEDS_TRACK 并列出赛道。 |
| trigger_hint | string | – | 特效触发提示,开拍时显示,如「张嘴试试」:最多 10 个字;省略时保留页面带出的内容,传空串清空。 |
No output schema declared.
No examples provided.
task_bind ~207
把工程绑定到一个已领取的任务,和从任务详情页点「去创作」打开的工程一样,提交时会带上该任务。编辑器只在打开工程时写入任务信息,所以本工具会先关闭该工程的窗口(有未保存改动时拒绝,先 save_project),再带着任务信息重新打开,返回新的 pid 和 instance_id。带任务的打开要经由另一个开着的窗口发起,这个工程是唯一的窗口时,会先开一个不保存的空工程当跳板,绑完关掉。task_id 须来自本会话的 tasks_list。只在提交时选任务的话,直接给 submit_prepare 传 task(已领取任务的标题),不用重开窗口。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | 工程文件夹的绝对路径。 |
| task_id | string | yes | tasks_list 返回的 task_id(须 bindable=true)。 |
No output schema declared.
No examples provided.
task_detail ~559
一个特效征集任务的详情:状态、奖励时间、下线时间、我提交到这个任务的特效 my_effects(名称、effect_id、审核状态、拍摄数、播放数、投稿峰值、获奖金额、任务评定 task_state(pending 待评定,任务页不显示标签;unfinished 任务未完成;done 任务已完成;认不出的值原样给)和 off_theme(任务页标了「主题不符合」)、赛道)、完成状态、是否分档任务、任务页推荐工程的模板 id recommended_template_ids(去重后最多前 20 个,总数在 recommended_template_total,全部见 save_to;目前没有工具能按它直接下载,只能当线索),和整理过的任务说明 content:每个内容块(参与要求、奖项详情、近期热门、任务说明等)有名称 name、条目 items 和链接 links;条目有标题 title、正文 text(页面里的链接标记已换成文字,链接放进 links)、参考图 image_refs 和参考视频 video_refs,奖项条目另有页面原样给的金额 money、发放方式 money_mode 和名额 people(unlimited 为不限);空地址和 blob: 地址任务页里也显示不出来,只在 unusable_media 里计数;读不懂的字段原样放进 unread。要原始返回时传 save_to。task_id 来自 tasks_list 或 my_task_status(本会话没列过时自动先读一次任务列表);活动没有详情,成长任务用 growth_task_detail。只看所有任务里自己作品的评定,用 my_task_status 一次取全。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| save_to | string | – | 把接口的原始返回另存到这个目录(绝对路径),文件名 task_detail-<task_id>.json,长期保留。 |
| task_id | string | yes | tasks_list 返回的 task_id。 |
No output schema declared.
No examples provided.
task_receive ~150
领取一个征集任务(写入当前登录账号,与活动中心的「领取」按钮相同,领取后不能撤销)。只有状态为 WAIT_RECEIVE 的任务能领,其它状态直接拒绝。返回 designer_task_id 和新状态;领取后本工具会重新读一次任务列表,接着就能 task_bind。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| task_id | string | yes | tasks_list 返回的任务 task_id。 |
No output schema declared.
No examples provided.
tasks_list ~293
按 offset / count 分页列出首页活动中心的活动和特效征集任务:标题、状态(如 WAIT_RECEIVE 待领取 / WAIT_SUBMIT 待提交)、是否已领取、状态说明(如「查看官方指导,帮您完成任务」)、剩余天数、收益、上下线时间、可完成次数。拿到 task_id 后用 task_detail 看详情、task_receive 领取、task_bind 绑定到工程(bindable=true 的才能绑)。成长任务用 growth_tasks_list。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
tutorial_search ~247
按关键词搜索像塑官方教程(像塑移动版搜索页同一接口):字段同 tutorials_list。按 cursor 翻页,每页最多 20 条。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20(最大 20,更多服务端报错)。 |
| cursor | integer | – | 翻页游标,取上一页的 next_cursor。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| query | string | yes | 关键词,如「美妆」「测一测」「变装」。 |
No output schema declared.
No examples provided.
tutorials_list ~415
像塑官方教程(移动版「教程」页同一组接口):每次都带上全部分类 tabs(特效:新手入门、特效进阶、精选课程、PC工具、工程实操、三方工具、爆款分享、账号运营、视频教程;模板:模板入门、模板进阶等),按 tab_id 列出一个分类的教程,不传时列出全部(约 190 篇,比各分类之和多)。每篇有标题、标签(如「新手必看」「拍视频脚本」)、学习人数、作者、上线日期、是否付费、文档链接 link(飞书文档,要登录飞书才能打开,agent 读不到正文,只能看标题和标签)、封面 cover_ref 和视频 video_ref(视频教程才有,交给 image_view 拿到的地址能直接打开)。按 offset / count 分页。按关键词找教程用 tutorial_search。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | 每页数量,默认 20。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| tab_id | integer | – | 分类 ID,取返回的 tabs 里的 tab_id;省略时列出全部教程。 |
No output schema declared.
No examples provided.
works_by_effect ~495
按特效 ID 查排行榜等处给出的特效(rank_list / rank_subject_detail / rank_innovation / effect_search 的 effect_id)在首页有没有工程,与首页搜索框「特效ID」搜索同一个接口。逐个返回 status:found 首页有这个特效的工程;same_style 首页没有它,但像塑移动版「做同款」按钮指向首页上的一个工程(same_style 给出那个工程所属特效的 effect_id 和名称,常常是别人的另一个特效,如「顶美精致淡妆感」指向「可可裸妆」,不是这个特效本身的工程);same_name 首页没有它、也没有做同款工程,只有同名作品(effect_id 不同,可能是别人的同名作品,不能当成同一个特效);not_on_homepage 拿不到工程。做同款工程不在首页时 same_style 仍会给出,status 按同名作品的查找结果。found、same_style 和 same_name 的作品在 items 里(字段同 works_list),template_id 可直接用于 works_download / works_open。默认在「推荐」里查:按特效 ID 查时「推荐」也能查到只在其它分类出现的作品,在别的分类里按 ID 查反而查不到,所以一般不用给 category_id。每个特效一到四次请求。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | string | – | works_list 返回的 categories 里的分类 ID;省略时用第一个分类(推荐)。 |
| effects | array | yes | 要查的特效,最多 20 个(一页排行榜)。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
No output schema declared.
No examples provided.
works_cleanup ~107
删除 works_download / works_open 下载过的作品工程(像塑临时目录里的和 dest 副本)。省略 paths 时删除全部;编辑器窗口正开着的会保留并在 kept_open 里列出,关窗后再调用即可。只删登记过的下载,其它路径一律拒绝。
| Name | Type | Req | Description |
|---|---|---|---|
| paths | array | – | 只删这些下载(works_download / works_open 返回的 project_path);省略时删除全部。 |
No output schema declared.
No examples provided.
works_download ~363
下载一个首页作品的完整工程并解压(与在首页点开作品同一流程,但不打开窗口),返回工程目录和文件概况:key_files 只列学做法要读的文件(effect.dyehpj、场景 .scene 及其 .extra、Graph 下的文件和作者的 .js / .ts 脚本,相对路径和大小;官方素材包 _DynamicAsset 里自带的脚本不列),其余贴图、模型只给总数 file_count 和按扩展名的计数 by_extension,要看时自己列目录。dest 给定时把工程放到该目录(须不存在或为空,跳过 Library 缓存),像塑临时目录里的那份随即删除。下载的工程(含 dest)都会登记,expires_at(24 小时)后在下次下载时自动删除;学完请立即调用 works_cleanup。同一窗口的多个下载会排队一个个下,可以一起发出。要在编辑器里看效果用 works_open。作品版权归原作者,只用于学习参考,不要复制进自己的工程或仓库。
| Name | Type | Req | Description |
|---|---|---|---|
| dest | string | – | 工程要放到的文件夹绝对路径(须不存在或为空);省略时留在像塑的临时目录。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| template_id | string | yes | works_list / works_search / works_by_effect 返回的 template_id。 |
No output schema declared.
No examples provided.
works_list ~403
分页列出像塑首页「模板」某个分类下的作品。首页作品是完整的像塑工程(官方工程和用户投稿),可下载到本地阅读、学习其场景和脚本做法;任意一个工程窗口开着即可。每次都带上全部分类 categories(推荐、官方工程、新手必做、游戏、妆容、AI玩法等)。每条作品有 template_id、标题、标签、已发布到抖音的特效 ID 和发布量(effect_id / publish_count,没有则为 null)、使用量、工程包大小、封面 cover_ref 和动图 gif_ref(交给 image_view 看)。拿到 template_id 后用 works_download 下载工程。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | string | – | works_list 返回的 categories 里的分类 ID;省略时用第一个分类(推荐)。 |
| count | integer | – | 每页数量,默认 20。 |
| cursor | string | – | 翻页游标,原样取上一页的 next_cursor;最后一页的 next_cursor 是 null。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| sort | string | – | 排序:suggest 推荐(默认)、latest 最新、effect_usage 特效使用量、project_usage 工程使用量。 |
No output schema declared.
No examples provided.
works_open ~174
下载一个首页作品并在新的编辑器窗口里打开,与在首页点开作品同一流程(不弹版本升级提示,工程处于未保存状态)。返回窗口 pid、官方 instance_id 和工程目录,之后可用 get_scene、capture_preview 等官方工具观察它的做法。看完用 project_close(discard_changes=true)关窗,再 works_cleanup 删除下载;窗口开着时工程不会被删除。
| Name | Type | Req | Description |
|---|---|---|---|
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| template_id | string | yes | works_list / works_search / works_by_effect 返回的 template_id。 |
No output schema declared.
No examples provided.
works_search ~491
按作品名搜索首页作品(与首页搜索框同一个接口)。不给 category_id 时搜全部分类并合并去重:「推荐」翻到底只有约 300 条,「美化」「友友天地」等分类里还有它没有的作品。合并顺序是先「推荐」里的(按 sort),再按分类顺序追加只在其它分类出现的;每个分类最多 300 条。每条带 found_in(出现在哪些分类),另返回 total、by_category(各分类条数)。queries 一次搜多个词(最多 8 个)并合并,每条带 matched_queries。按 offset / count 分页,结果缓存 10 分钟,翻页不重新请求。某个分类翻页时服务端一直给同一页,会列在 incomplete 里。其余字段同 works_list。按特效 ID 查用 works_by_effect。 返回里的图片、视频、音频给的是短引用(*_ref / *_refs 字段,如 img:12、video:3)。看图时把引用放进 image_view 的 images 数组(参数名就是 images,如 images: ["img:12", "img:13"]):图片直接显示,视频和音频返回原地址;引用在 MCP 服务这次运行期间有效。
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | string | – | 只搜这个分类(works_list 返回的 categories 里的分类 ID);省略时搜全部分类。 |
| count | integer | – | 每页数量,默认 20。 |
| instance_id | string | – | 官方 list_instances 返回的 instance_id,与 project_path 二选一。 |
| offset | integer | – | 分页起点,取上一页的 next_offset;默认 0。 |
| project_path | string | – | 目标工程的绝对路径。与 instance_id 二选一;只开了一个工程窗口时都可省略。 |
| queries | array | – | 一次搜多个词并合并,如 ["头套", "头饰"]。与 query 二选一。 |
| query | string | – | 作品名关键词,如「合掌」「转场」「换装」。与 queries 二选一。 |
| sort | string | – | 排序:suggest 推荐(默认)、latest 最新、effect_usage 特效使用量、project_usage 工程使用量。 |
No output schema declared.
No examples provided.
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
claude mcp add muqian-sun-xiangsu-mcp-plus -- npx -y @muqian/xiangsu-mcp-plus
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 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 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 22 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.