OmniDebugLink

dev.omnidebuglink由 omnidebuglink.dev 发布官方发布者v0.2.0更新于 Oct 24, 2026

remote debug iOS/Android/Unity/Godot/Flutter/RN/Web on real-device.ui-tree/screenshots/taps,tests.

已验证Streamable HTTP可网页运行浏览器自动化开发者工具

概览

AI 生成的概览

远程 MCP 服务器，让 AI 编程工具在真实设备上检查并操控运行中的 iOS、Android、Unity、Godot、Flutter、React Native 或 Web 应用。

可以做什么
列出已连接设备并查看状态，通过 list_devices、run_task、device_status、list_tasks 等 MCP 工具列出并执行任务。检查运行中应用的 UI 树并截图。通过点击、滑动和输入文字操控应用。在真实硬件上读取日志并测量性能。设备只需一条出站 WebSocket 连接，即可跨网络工作，无需 USB 线、共享网络或模拟器。
适用场景
适合需要让 AI 编程代理在真实硬件上调试或测试移动端、游戏或 Web 应用时使用，包括位于 NAT 之后或处于其他网络的设备；也适合在不用模拟器或数据线的情况下进行自动化 UI 交互和截图。
运行要求
通过 streamable HTTP 访问的远程端点，需在浏览器中完成 OAuth 登录。需在服务商控制台创建设备令牌对，并在应用中集成对应的客户端 SDK（Unity、Android、Flutter、iOS/macOS、React Native、Godot 或 Web）。设备需要出站 WebSocket 连接。未声明环境变量或请求头。
安装前请注意
需要 OAuth 登录和按设备分配的令牌对；一对令牌对应一个设备席位。令牌绝不能嵌入发布版本，发布版只能通过条件模式使用运行时下发的令牌。该服务器可在运行中的应用内点击、滑动和输入，会改变应用状态。应用数据和设备交互会经过服务商的中继。控制台仅在公开测试期间免费。

安装

在 SourceWeft 中

  1. 打开 控制台中的 OmniDebugLink，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.omnidebuglink%2Fomnidebuglink/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "omnidebuglink": {
      "type": "http",
      "url": "https://api.omnidebuglink.dev/mcp"
    }
  }
}

README

OmniDebugLink

Remote debugging and automated testing on real devices — from anywhere.

Add a small client SDK to your app, connect it with a device token, and any AI coding tool (Claude Code, Cursor, Codex, Gemini CLI, …) can inspect and drive the running app over Model Context Protocol: dump the UI tree, take screenshots, tap, swipe, type, read logs, measure performance — no USB cable, no shared network, no emulator.

Your App ──wss──> OmniDebugLink relay ──MCP──> AI coding tool
  • One outbound WebSocket from the device — works across networks, behind NAT, on real hardware.
  • The AI side sees plain MCP tools: list_devices → run_task / device_status / list_tasks …
  • One token pair = one device seat. Tokens are per-device; never embed one in a release build — release use goes through the conditional pattern.

Client SDKs

PlatformInstallRepo
UnityPackage Manager → add from git URLomnidebuglink_unity
AndroidJitPack: com.github.omnidebuglink:omnidebuglink_android:<tag>omnidebuglink_android
Flutterpubspec git dependency (ref: tag)omnidebuglink_flutter
iOS / macOSSwift Package (iOS 15+ / macOS 12+)omnidebuglink_apple_swift
React Nativenpm i omnidebuglink/omnidebuglink_react_native#<tag>omnidebuglink_react_native
Godotcopy the addons/omni_debug_link/ folder (Godot ≥ 4.2)omnidebuglink_godot
WebCDN build via jsDelivr (@<tag>)omnidebuglink_web

Each SDK repo has the full install steps and task tables for its platform. Pin a version tag (#vX.Y.Z / ref: / @vX.Y.Z) in production hosts.

Quickstart

  1. Create a device token pair at the console (free during the public beta).

  2. Connect your app: add the SDK for your platform and start it with the token — freely in debug builds; in release builds only via the conditional pattern (runtime-issued token, never embedded).

  3. Add the MCP server to your AI tool (OAuth login in the browser):

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

    Works with any MCP client: Cursor, Codex CLI, Gemini CLI, …

  4. Ask the AI to list_devices and start driving the device.

Integrating an SDK into your app

sdk-integration.md is written to be handed to your AI coding tool verbatim — per-platform install and connect snippets, the rules that must not be broken, and a verification checklist. Ask the agent to read it and wire the SDK in.

Building a client for another platform?

Any platform with a WebSocket client can join — the wire protocol is a single JSON frame format:

→ Third-Party Client Development Guide — protocol spec, a portable reference implementation, known pitfalls, and a pre-deployment verification checklist. AI coding agents can implement a compliant client from this guide alone, without reading any SDK source.

Links

来源：README.md，提交 512c8c6

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。