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

Android Studio

{
  "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" }
    }
  }
}

Copilot

{
  "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" }
    }
  }
}

Codex

Use STDIO

command: npx

args:

• --yes
• mobile-debug-mcp

environment variables:

• ADB_PATH: /path/to/adb
• XCRUN_PATH: /usr/bin/xcrun
• IDC_PATH: /path/to/idb"

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

License

MIT