mobile-debug-mcp

Mobile Debug Tools

A minimal, secure MCP server for AI-assisted mobile development. Build, install, interact and inspect Android/iOS apps from an MCP-compatible client.

Support:

• KMP
• Android
• iOS
• Flutter - not tested
• React native - not tested

Requirements

• Node.js >= 18
• Android SDK (adb) for Android support
• Xcode command-line tools for iOS support
• idb for iOS device support

Configuration example

{
  "mcpServers": {
    "mobile-debug": {
      "command": "npx",
      "args": ["--yes","mobile-debug-mcp","server"],
      "env": { "ADB_PATH": "/path/to/adb", "XCRUN_PATH": "/usr/bin/xcrun", "IDB_PATH": "/path/to/idb" }
    }
  }
}

You will need to add ADB_PATH for Android and XCRUN_PATH and IDB_PATH for iOS.

Usage

Examples:

Crash fixing:

I have a crash on the app, can you diagnose it, fix and validate using the mcp tools available

Feature building:

Add a button, hook into the repository and confirm API request successful

Docs

• Tools: Tools — full input/response examples
• Changelog: Changelog
• Agents: AGENTS.md — cold-start guidance for autonomous agents entering the public repo
• Skills: skills/README.md — portable Markdown skill packages for agents such as Copilot, Codex, Claude, or custom systems

Testing

• npm run test:unit runs every automated unit test under test/unit/...
• npm run test:device runs the automated device smoke checks under test/device/automated/...
• npm run verify runs the default maintainer verification sequence: lint, build, and unit tests
• Manual and debug-oriented device scripts live under test/device/manual/... and are not part of the default test commands

Utility Scripts

• npm run healthcheck runs the idb/tooling healthcheck helper from src/utils/cli/idb/check-idb.ts
• npm run install-idb runs the guided idb installer helper from src/utils/cli/idb/install-idb.ts
• npm run preflight-ios runs the iOS preflight helper from src/utils/cli/ios/preflight-ios.ts

Agent skills

• skills/mcp-builder/ contains reusable build/install guidance for agents
• skills/test-authoring/ contains reusable test-creation guidance aligned to this repo's current test structure
• Skills are written as plain Markdown packages so they can be consumed by different agent systems rather than one vendor-specific runtime

License

MIT