sleepyquq/xiangsu-mcp

像塑 MCP | AI Agent scene editing, scripting and playtesting for Douyin Xiangsu 9.4. Effect House compatibility unverified.

About xiangsu-mcp

让 AI Agent 通过 Model Context Protocol（MCP）操作抖音像塑：编辑场景、绑定素材、初始化 TypeScript 脚本、编译、截图和验证交互。

Xiangsu MCP is an independent MCP server for the Douyin Xiangsu AR effect editor. It exposes scene editing, asset binding, TypeScript scripting, compilation, preview screenshots and interactive playtesting to MCP clients. Verified target: Windows + Xiangsu 9.4.0. International TikTok Effect House compatibility is not verified.

- 项目版本：0.2.0，使用 Node.js 和 stdio MCP，编辑器侧通过用户插件桥接。 - 当前提供 105 个工具入口；入口数量包含兼容入口和明确未接入的云端入口，不代表 105 项均已实测。 - 独立社区项目，非字节跳动、抖音或 TikTok 官方产品。不宣称完整替代官方 Agent / Ask AI。 - 安装 · 功能与验证状态 · AI 使用指引 · English quick start

“已实测”指在像塑 9.4.0 的测试副本中完成相应操作并读回、编译或检查真实预览；不表示该工具的全部参数组合均已覆盖。详细证据范围见 9.4 验证记录。

能力 当前实现 验证情况 --------- 会话与工程发现 查询已打开工程，按 projectPath / sessionId 绑定操作 已验证；同工程多窗口需指定会话 场景读写 sceneSpec 实时场景读取；sceneOps 平铺 DSL，创建、修改、显隐与读回 文字、图片、布局、颜色、对齐、贴图等已实测；复杂父级变换待验证 脚本开发 setupGameScript 初始化、依赖同步、序列化资源字段绑定 挂载、编译失败与修复、Texture / Material 绑定已实测 编译与日志 官方编译器、日志分页、错误返回 已实测；失败不会伪装成成功 试玩与状态 playLifecycle / playStep / playState 等，开始、暂停、重启、结束 Game2D 就绪、真实运行帧、重启隔离、结束恢复已实测 预览与录像 截图、触摸、动作切换、MP4 录制 截图、触摸、张嘴/握拳/挥手、非空 MP4 已实测；拖拽等未逐项验证 音频输入模拟 模拟音高、音量、关键词检测结果，确认接收并清空 已实测；这是检测输入模拟，不生成声音 工程文件 限定路径读写、SHA256 覆盖保护、备份 自动化测试覆盖；不允许直接覆盖主场景文件 本地素材处理 图片裁剪、压缩、静态 SVG 转 PNG 有本地测试覆盖；完整生成素材到最终预览链路待验证 代码查询 基于 TypeScript 的本地符号查询 有本地测试覆盖；不是官方私有 CKG 引擎 原生命令映射 71 个 eh 本地命令入口 尚未逐项实测；预制件、包导入、复杂材质、物理和快照等仍需专项回归 官方资料读取 从本机安装目录提供 Skill、API 和资源说明 按需通过 MCP resources 读取，不附带官方文档包 官方云端生成 7 个图片/音频生成及等待任务入口 未接入，返回 OFFICIALCLOUDBACKENDNOTADAPTED

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/sleepyquq--xiangsu-mcp.html)

Related MCP servers