关于 OmniDebugLink
OmniDebugLink 将真实设备上的应用连接到 AI 编码工具,用于远程调试和自动化测试。各平台 SDK 通过中继连接,Agent 可借助 MCP 工具检查和操作设备,无需 USB 线缆或共享网络。
主要功能
- 01查看 UI 树和屏幕截图
- 02点击、滑动并输入文本
- 03读取日志并测量性能
- 04通过平台 SDK 和 WebSocket 中继连接应用
- 05通过 MCP 列出设备并管理任务
适用场景
- 01调试远程设备上运行的应用
- 02在真实硬件上执行交互测试
- 03复现问题时检查日志和性能
MCP 相关
它通过 OmniDebugLink API 提供 HTTP MCP 服务,供 AI 编码工具列出设备、运行任务、查看设备状态和列出任务。应用使用平台 SDK 和设备令牌连接中继。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.omnidebuglink.dev/mcpclaude mcp add --transport http dev-omnidebuglink-omnidebuglink https://api.omnidebuglink.dev/mcp{"mcpServers":{"dev-omnidebuglink-omnidebuglink":{"type":"http","url":"https://api.omnidebuglink.dev/mcp"}}}在 Cursor 中打开{"servers":{"dev-omnidebuglink-omnidebuglink":{"type":"http","url":"https://api.omnidebuglink.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"dev-omnidebuglink-omnidebuglink":{"type":"http","url":"https://api.omnidebuglink.dev/mcp"}}}{"mcpServers":{"dev-omnidebuglink-omnidebuglink":{"serverUrl":"https://api.omnidebuglink.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
OmniDebugLink
随时随地在真实设备上进行远程调试和自动化测试。
只需在应用中添加一个小型客户端 SDK,使用设备令牌连接,任何 AI 编码工具(Claude Code、Cursor、Codex、Gemini CLI,……)都能通过 Model Context Protocol 检查并操控正在运行的应用:转储 UI 树、截取屏幕截图、点击、滑动、输入文字、读取日志、测量性能——无需 USB 线缆、共享网络或模拟器。
Your App ──wss──> OmniDebugLink relay ──MCP──> AI coding tool
- 设备只需建立一个出站 WebSocket 连接——可跨网络使用,可在 NAT 后运行,也适用于真实硬件。
- AI 端看到的是普通 MCP 工具:
list_devices→run_task/device_status/list_tasks… - 一对令牌对应一个设备席位。令牌按设备分配;切勿将令牌嵌入发布版本——发布版本中的使用需遵循条件模式。
客户端 SDK
| 平台 | 安装方式 | 仓库 |
|---|---|---|
| Unity | Package Manager → 从 git URL 添加 | omnidebuglink_unity |
| Android | JitPack:com.github.omnidebuglink:omnidebuglink_android:<tag> | omnidebuglink_android |
| Flutter | pubspec git 依赖项(ref: 标签) | omnidebuglink_flutter |
| iOS / macOS | Swift Package(iOS 15+ / macOS 12+) | omnidebuglink_apple_swift |
| React Native | npm i omnidebuglink/omnidebuglink_react_native#<tag> | omnidebuglink_react_native |
| Godot | 复制 addons/omni_debug_link/ 文件夹(Godot ≥ 4.2) | omnidebuglink_godot |
| Web | 通过 jsDelivr 使用 CDN 构建版本(@<tag>) | omnidebuglink_web |
每个 SDK 仓库都提供该平台的完整安装步骤和任务表。
在生产环境的主机中固定使用版本标签(#vX.Y.Z / ref: / @vX.Y.Z)。
快速开始
-
创建一对设备令牌:前往控制台(公开测试期间免费)。
-
连接应用:添加适用于你平台的 SDK,并使用令牌启动——调试版本可自由使用;发布版本则只能遵循条件模式(通过运行时签发令牌,绝不嵌入令牌)。
-
将 MCP 服务添加到 AI 工具中(在浏览器中通过 OAuth 登录):
claude mcp add --transport http odl https://api.omnidebuglink.dev/mcp适用于任何 MCP 客户端:Cursor、Codex CLI、Gemini CLI,……
-
让 AI 调用
list_devices并开始操控设备。
将 SDK 集成到应用中
sdk-integration.md 的编写方式便于直接交给 AI 编码工具使用——其中包含各平台的安装和连接代码片段、必须遵守的规则,以及验证清单。让 Agent 阅读该文档并完成 SDK 接入。
要为其他平台构建客户端?
任何支持 WebSocket 客户端的平台都可以接入——线缆协议采用单一 JSON 帧格式:
→ 第三方客户端开发指南 — 协议规范、可移植的参考实现、已知问题和部署前验证清单。AI 编码 Agent 仅凭本指南即可实现符合规范的客户端,无需阅读任何 SDK 源码。
链接
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。