# deepadb

An MCP server that hands your agent 209 ADB tools for Android: UI inspection, logs, diagnostics, firmware and hardware work.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Author: fullread
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/fullread/DeepADB
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/deepadb

## What it does

DeepADB runs as a local MCP server and talks to the phone over ADB on USB by default. Start it on the device itself, inside Termux, and it detects that and switches to running commands through `sh`/`su` — no ADB daemon, no cable.

The surface comes from 49 modules, which add up to 209 tools plus a few resources and prompts. Transient failures get retried, timeouts are handled, and with several phones plugged in the server routes by serial. Tools that depend on a binary the host lacks say so instead of failing silently.

Building from source needs Node.js: `npm ci`, then `npm run build`. Point your MCP client at `build/index.js`. Exposing HTTP, WebSocket or GraphQL past loopback is where `SECURITY.md` matters.

Standard mode was tested against a Pixel 6a on Android 16, with the suite passing on both the host and on-device setups.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add deepadb -- npx -y deepadb
```

### Codex

**Platform CLI**
```bash
codex mcp add deepadb -- npx -y deepadb
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "deepadb": {
            "command": "npx",
            "args": [
                "-y",
                "deepadb"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "deepadb": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "deepadb"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add deepadb npx -y deepadb
```

## When to use it
- read the current screen and UI tree of an Android app
- pull `logcat` and `dumpsys` while debugging a crash
- verify the ADB toolchain and list attached devices
- capture an app's network traffic
- inspect baseband and firmware state

## Example prompts
- Run `adb_health_check`, then list `adb_devices`
- Grab `adb_screen_state` and `adb_ui_dump` from the connected phone
- Collect `adb_device_info` and `adb_logcat` for the app that crashed

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9751
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5149

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md