抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
一个基于CDP,提供小程序模拟器自动化功能的模型上下文协议 (MCP) 服务器。该服务器使 LLM 能够通过结构化的可访问性快照与模拟器进行交互,从而无需屏幕截图或视觉调整后的模型。

主要特点

    •快速轻便。使用 CDP 的 DOMSnapshot ,而非基于像素的输入。
    •对LLM友好。无需视觉模型,完全基于结构化数据运行。
    •确定性工具应用。避免了基于屏幕截图方法常见的歧义。

要求

    •抖音小程序开发者工具 4.5.2 及以上版本
    •能连接 MCP 的 AI 工具(包含 TRAE、Cursor、Claude Code 等)

使用方法

    •首先,使用开发者工具打开一个小程序项目,等待模拟器加载完毕后,在顶部菜单栏选择【抖音开发者工具】-【设置】
    •选择【调试】栏目,并开启 MCP,并复制 MCP Server 的 URL
    •配置 MCP,配置成功后可看到 MCP Tools 列表
{ "mcpServers": { "simulator": { "url": "http://127.0.0.1:8001/mcp" // 复制下来的url } } }

Tools

工具名称
描述
参数
miniapp-snapshot
​
获取抖音开发者工具模拟器的页面快照信息。快照信息是短期的信息,当进行页面操作后很可能会变化,每次进行操作前需要重新获取。
None
miniapp-tap
​
在抖音开发者工具模拟器中点击指定元素,支持单击和长按操作。可传入元素的backendId或坐标进行点击。
    •backendId (string, optional): 要点击的元素的backendId,需要从miniapp-snapshot中获取
    •type ( enum: ['tap', 'longtap']): 点击操作类型,tap为单击,longtap为长按
    •x (number, optional): 点击操作的横坐标
    • y (number, optional): 点击操作的横坐标
miniapp-input
​
在抖音开发者工具模拟器中输入指定文本或按键,支持输入文本、按键和命令,不支持组合键
    •type ( enum: ['char', 'key', 'command']): 输入类型,char表示输入文本,key表示输入按键,command表示输入命令
    •code (string, optional): 按键代码,例如KeyA。输入类型为key时需要传入
    •text (string, optional): 要输入的文本。输入类型为char时需要传入
    •command (enum: ['selectAll', 'delete'], optional): 要输入的命令。输入类型为command时需要传入。可选值为selecAll(全选)和delete(删除)
miniapp-scroll
在抖音开发者工具模拟器中滚动页面
    •umber, optional): The distance to scroll along the X axis (positive to scroll left)
    • y (number, optional): The distance to scroll along the Y axis (positive to scroll up)
miniapp-image-screenshot
​
获取抖音开发者工具模拟器的页面截图,截图保存在系统临时目录
None
    •miniapp-navigate
​
在抖音开发者工具模拟器中导航到指定页面
    •type ( enum: ['navigateTo', 'redirectTo', 'switchTab', 'navigateBack', 'reLaunch']): 导航操作类型,默认值为navigateTo。可选值为navigateTo(导航到新页面)、redirectTo(重定向到新页面)、switchTab(切换到新tabbar页面)、navigateBack(返回上一页)、reLaunch(关闭所有页面,打开应用内的某个页面。)
    •url (string, optional): 要导航到的页面URL,navigateTo、redirectTo、switchTab、reLaunch时需要传入
miniapp-get-console-messages
获取抖音开发者工具模拟器的console消息
None
miniapp-get-current-page-data
​
获取抖音开发者工具模拟器当前页面的data数据
None
miniapp-execute-js
在抖音开发者工具模拟器中执行指定的js代码
    •js (string): 要执行的js代码
    •awaitPromise (boolean, optional): Whether execution should `await` for resulting value and return once awaited promise isresolved. default false
miniapp-get-attributes
获取抖音开发者工具模拟器中指定元素的属性
    •backendId (string): 要获取属性的元素的backendId,需要从miniapp-snapshot中获取
miniapp-get-computed-style
获取抖音开发者工具模拟器中指定元素的计算样式
    •backendId (string): 要获取计算样式的元素的backendId,需要从miniapp-snapshot中获取

示例

    •Trae 中使用
    ◦配置示例
    ◦使用示例:
​
​
​
​
​
​
​
​
​