mcpField
O
OmniDebugLink

OmniDebugLink

远程服务
omnidebuglink.dev开发工具07 周前更新

关于 OmniDebugLink

OmniDebugLink 将真实设备上的应用连接到 AI 编码工具,用于远程调试和自动化测试。各平台 SDK 通过中继连接,Agent 可借助 MCP 工具检查和操作设备,无需 USB 线缆或共享网络。

主要功能

  1. 01查看 UI 树和屏幕截图
  2. 02点击、滑动并输入文本
  3. 03读取日志并测量性能
  4. 04通过平台 SDK 和 WebSocket 中继连接应用
  5. 05通过 MCP 列出设备并管理任务

适用场景

  1. 01调试远程设备上运行的应用
  2. 02在真实硬件上执行交互测试
  3. 03复现问题时检查日志和性能

MCP 相关

它通过 OmniDebugLink API 提供 HTTP MCP 服务,供 AI 编码工具列出设备、运行任务、查看设备状态和列出任务。应用使用平台 SDK 和设备令牌连接中继。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://api.omnidebuglink.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;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

平台安装方式仓库
UnityPackage Manager → 从 git URL 添加omnidebuglink_unity
AndroidJitPack:com.github.omnidebuglink:omnidebuglink_android:<tag>omnidebuglink_android
Flutterpubspec git 依赖项(ref: 标签)omnidebuglink_flutter
iOS / macOSSwift Package(iOS 15+ / macOS 12+)omnidebuglink_apple_swift
React Nativenpm 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)。

快速开始

  1. 创建一对设备令牌:前往控制台(公开测试期间免费)。

  2. 连接应用:添加适用于你平台的 SDK,并使用令牌启动——调试版本可自由使用;发布版本则只能遵循条件模式(通过运行时签发令牌,绝不嵌入令牌)。

  3. 将 MCP 服务添加到 AI 工具中(在浏览器中通过 OAuth 登录):

    claude mcp add --transport http odl https://api.omnidebuglink.dev/mcp
    

    适用于任何 MCP 客户端:Cursor、Codex CLI、Gemini CLI,……

  4. 让 AI 调用 list_devices 并开始操控设备。

将 SDK 集成到应用中

sdk-integration.md 的编写方式便于直接交给 AI 编码工具使用——其中包含各平台的安装和连接代码片段、必须遵守的规则,以及验证清单。让 Agent 阅读该文档并完成 SDK 接入。

要为其他平台构建客户端?

任何支持 WebSocket 客户端的平台都可以接入——线缆协议采用单一 JSON 帧格式:

→ 第三方客户端开发指南 — 协议规范、可移植的参考实现、已知问题和部署前验证清单。AI 编码 Agent 仅凭本指南即可实现符合规范的客户端,无需阅读任何 SDK 源码。

链接

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。