English Français العربية

OmniDebugLink

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http omnidebuglink 'https://api.omnidebuglink.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "omnidebuglink": {
            "type": "http",
            "url": "https://api.omnidebuglink.dev/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OmniDebugLink
  2. Client SDKs
  3. Quickstart
  4. Integrating an SDK into your app
  5. Building a client for another platform?
  6. Links

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):

     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.

الأسئلة الشائعة

ما هو OmniDebugLink؟

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

كيف أثبّت OmniDebugLink؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http omnidebuglink 'https://api.omnidebuglink.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج OmniDebugLink إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل OmniDebugLink مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون OmniDebugLink؟

ينشره omnidebuglink. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.