模拟器 MCP
一个基于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或坐标进行点击。 |
|
miniapp-input | 在抖音开发者工具模拟器中输入指定文本或按键,支持输入文本、按键和命令,不支持组合键 |
|
miniapp-scroll | 在抖音开发者工具模拟器中滚动页面 |
|
miniapp-image-screenshot | 获取抖音开发者工具模拟器的页面截图,截图保存在系统临时目录 | None |
| 在抖音开发者工具模拟器中导航到指定页面 |
|
miniapp-get-console-messages | 获取抖音开发者工具模拟器的console消息 | None |
miniapp-get-current-page-data | 获取抖音开发者工具模拟器当前页面的data数据 | None |
miniapp-execute-js | 在抖音开发者工具模拟器中执行指定的js代码 |
|
miniapp-get-attributes | 获取抖音开发者工具模拟器中指定元素的属性 |
|
miniapp-get-computed-style | 获取抖音开发者工具模拟 器中指定元素的计算样式 |
|
示例
- •Trae 中使用
- ◦配置示例
- ◦使用示例:
