# DeepADB MCP server

> Enables AI agents to inspect, control, test, and diagnose Android devices through ADB or direct on-device execution via Termux.

- Repository: https://github.com/fullread/DeepADB
- Page: https://hostedmcp.org/servers/fullread/deepadb
- Transport: stdio
- Stars: 23
- License: Apache-2.0
- Latest version: 1.1.7

## Install

### Claude Code

```sh
claude mcp add deepadb -- npx -y deepadb
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "deepadb": {
      "command": "npx",
      "args": [
        "-y",
        "deepadb"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "deepadb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "deepadb"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"deepadb","type":"stdio","command":"npx","args":["-y","deepadb"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "deepadb": {
      "command": "npx",
      "args": [
        "-y",
        "deepadb"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add deepadb -- npx -y deepadb
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.deepadb]
command = "npx"
args = ["-y", "deepadb"]
```

### Gemini CLI

```sh
gemini mcp add -s user deepadb npx -- -y deepadb
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "deepadb": {
      "command": "npx",
      "args": [
        "-y",
        "deepadb"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DA_HTTP_HOST` | no | no |  |

## Tools (200)

- `adb_health_check`
- `adb_runtime_audit`
- `adb_devices`
- `adb_device_info`
- `adb_getprop`
- `adb_shell`
- `adb_root_shell`
- `adb_install`
- `adb_uninstall`
- `adb_list_packages`
- `adb_package_info`
- `adb_clear_data`
- `adb_grant_permission`
- `adb_revoke_permission`
- `adb_list_permissions`
- `adb_force_stop`
- `adb_start_app`
- `adb_restart_app`
- `adb_resolve_intents`
- `adb_sqlite_inspect`
- `adb_push`
- `adb_pull`
- `adb_ls`
- `adb_cat`
- `adb_file_write`
- `adb_find`
- `adb_file_stat`
- `adb_file_checksum`
- `adb_mkdir`
- `adb_rm`
- `adb_file_move`
- `adb_file_copy`
- `adb_file_chmod`
- `adb_file_touch`
- `adb_file_fsinfo`
- `adb_file_chown`
- `adb_grep`
- `adb_file_replace`
- `adb_logcat`
- `adb_logcat_clear`
- `adb_logcat_crash`
- `adb_logcat_start`
- `adb_logcat_poll`
- `adb_logcat_stop`
- `adb_logcat_sessions`
- `adb_dumpsys`
- `adb_telephony`
- `adb_battery`
- `adb_network`
- `adb_top`
- `adb_perf_snapshot`
- `adb_bugreport`
- `adb_crash_logs`
- `adb_heap_dump`
- `adb_app_route_context`
- `adb_screencap`
- `adb_screencap_annotated`
- `adb_current_activity`
- `adb_input`
- `adb_start_activity`
- `adb_ui_dump`
- `adb_ui_find`
- `adb_screen_state`
- `adb_screenrecord_start`
- `adb_screenrecord_stop`
- `adb_airplane_mode`
- `adb_airplane_cycle`
- `adb_wifi`
- `adb_mobile_data`
- `adb_location`
- `adb_screen`
- `adb_settings_get`
- `adb_settings_put`
- `adb_reboot`
- `adb_pair`
- `adb_connect`
- `adb_disconnect`
- `adb_tcpip`
- `adb_forward`
- `adb_reverse`
- `adb_forward_list`
- `adb_forward_remove`
- `adb_reverse_remove`
- `adb_tunnel_open`
- `adb_tunnel_list`
- `adb_tunnel_close`
- `adb_avd_list`
- `adb_emulator_start`
- `adb_emulator_stop`
- `adb_qemu_setup`
- `adb_qemu_images`
- `adb_qemu_start`
- `adb_qemu_stop`
- `adb_qemu_status`
- `adb_qemu_connect`
- `adb_qemu_disconnect`
- `adb_qemu_guest_shell`
- `adb_test_session_start`
- `adb_test_step`
- `adb_test_session_end`
- `adb_multi_shell`
- `adb_multi_install`
- `adb_multi_compare`
- `adb_multi_test`
- `adb_wear_datalayer_preflight`
- `adb_input_drag`
- `adb_input_fling`
- `adb_input_long_press`
- `adb_input_double_tap`
- `adb_input_text`
- `adb_open_url`
- `adb_orientation`
- `adb_clipboard`
- `adb_input_pinch`
- `adb_tap_element`
- `adb_wait_element`
- `adb_wait_stable`
- `adb_scroll_until`
- `adb_screenshot_compressed`
- `adb_batch_actions`
- `adb_screen_size`
- `adb_device_state`
- `adb_notifications`
- `adb_snapshot_capture`
- `adb_snapshot_compare`
- `adb_snapshot_restore_settings`
- `adb_tcpdump_start`
- `adb_tcpdump_stop`
- `adb_network_connections`
- `adb_ci_wait_boot`
- `adb_ci_device_ready`
- `adb_ci_run_tests`
- `adb_baseband_info`
- `adb_cell_identity`
- `adb_signal_detail`
- `adb_neighboring_cells`
- `adb_carrier_config`
- `adb_modem_logs`
- `adb_a11y_audit`
- `adb_a11y_touch_targets`
- `adb_a11y_tree`
- `adb_regression_baseline`
- `adb_regression_check`
- `adb_regression_history`
- `adb_farm_run`
- `adb_farm_results`
- `adb_farm_matrix`
- `adb_registry_search`
- `adb_registry_install`
- `adb_registry_installed`
- `adb_plugin_list`
- `adb_plugin_info`
- `adb_gradle`
- `adb_build_and_install`
- `adb_shannon_session`
- `adb_at_detect`
- `adb_at_send`
- `adb_at_batch`
- `adb_at_probe`
- `adb_at_cross_validate`
- `adb_screenshot_baseline`
- `adb_screenshot_diff`
- `adb_screenshot_history`
- `adb_workflow_run`
- `adb_workflow_validate`
- `adb_workflow_list`
- `adb_install_bundle`
- `adb_list_splits`
- `adb_extract_apks`
- `adb_apex_list`
- `adb_mirror_start`
- `adb_mirror_stop`
- `adb_mirror_status`
- `adb_test_gen_from_ui`
- `adb_test_gen_from_intents`
- `adb_test_gen_save`
- `adb_ota_fingerprint`
- `adb_ota_check`
- `adb_ota_history`
- `adb_ril_start`
- `adb_ril_poll`
- `adb_ril_stop`
- `adb_profile_detect`
- `adb_profile_save`
- `adb_profile_list`
- `adb_firmware_probe`
- `adb_firmware_diff`
- `adb_firmware_history`
- `adb_wifi_firmware`
- `adb_bluetooth_firmware`
- `adb_nfc_firmware`
- `adb_gps_firmware`
- `adb_market_search`
- `adb_market_install`
- `adb_market_export`
- `adb_selinux_status`
- `adb_selinux_denials`
- `adb_permission_audit`
- `adb_thermal_snapshot`
- `adb_thermal_compare`

## FAQ

### How does DeepADB run on Android?

It can run directly on the device through Termux using a LocalBridge mode that executes commands via sh/su.

### Can I use DeepADB with local LLMs?

Yes, it supports local LLM clients using direct stdio, authenticated browser HTTP, and small tool profiles.