FD

fullread/deepadb

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

20 stars 2 forks 质量 79 趋势 30Apache-2.0

功能齐全的Android调试桥MCP服务器——涵盖49个模块、5个资源和4个提示,涵盖UI到基带。

概览

MCP(模型上下文协议)服务器,专为需要通过ADB或直接在设备上通过Termux检测、控制、测试和诊断Android设备的AI代理提供。 ——从用户界面自动化和应用管理到日志、网络捕获、基带、固件、安全和硬件诊断。 DeepADB 作为本地 MCP 服务器运行。它默认使用 ADB,并在检测到 Android 设备上的 Termux 时自动切换为直接执行。 将构建/index.js添加到你的MCP客户端配置中,然后开始以下工作流程: 关于引导的本地连接,请参见 Claude 代码配置。在暴露 HTTP、WebSocket 或 GraphQL 传输(超出环回)之前,请阅读 SECURITY.md。 DeepADB 有两种运行模式,启动时自动检测: 标准模式:DeepADB 运行在 PC/Mac/Linux 主机上,并通过 USB 与设备通过 ADB 通信。

概述(AI 翻译)

MCP(模型上下文协议)服务器,专为需要通过ADB或直接在设备上通过Termux检测、控制、测试和诊断Android设备的AI代理提供。

209个工具、5个资源和4个提示,涵盖49个模块——从用户界面自动化和应用管理到日志、网络捕获、基带、固件、安全和硬件诊断。

开始吧

DeepADB 作为本地 MCP 服务器运行。它默认使用 ADB,并在检测到 Android 设备上的 Termux 时自动切换为直接执行。

在你的MCP客户端配置中添加build/index.js,然后开始以下工作流程:

目标 从
确认工具链和连接的设备 adb_health_check,然后是adb_devices
检查当前的安卓用户界面 adb_screen_state,然后是adb_ui_dump
诊断设备或应用 adb_device_info、adb_logcat 和 adb_dumpsys

关于引导的本地连接,请参见 Claude 代码配置。在暴露 HTTP、WebSocket 或 GraphQL 传输(超出环回)之前,请阅读 SECURITY.md。

建筑

双模架构

DeepADB 有两种运行模式,启动时自动检测:

ADB模式(默认)——PC端桥接器

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

DeepADB

MCP (Model Context Protocol) server for AI agents that need to inspect, control, test, and diagnose Android devices through ADB—or directly on-device through Termux.

209 tools, 5 resources, and 4 prompts across 49 modules—from UI automation and application management to logs, network capture, baseband, firmware, security, and hardware diagnostics.

Get started

DeepADB runs as a local MCP server. It uses ADB on a host computer and automatically switches to direct execution when running on Android (detected through /system/build.prop).

git clone https://github.com/fullread/DeepADB.git
cd DeepADB
npm ci
npm run build
npm start

Add build/index.js to your MCP client configuration, then begin with these workflows:

Goal Start with
Confirm the toolchain and connected device adb_health_check, then adb_devices
Inspect the current Android UI adb_screen_state, then adb_ui_dump
Diagnose a device or app adb_device_info, adb_logcat, and adb_dumpsys

For a guided local connection, see MCP Client Configuration. Read SECURITY.md before exposing HTTP, WebSocket, or GraphQL transports beyond loopback.

Using llama.cpp or another local model? See Local LLM clients for direct stdio, authenticated browser HTTP, and small tool profiles. WebSocket is not required.

Architecture

┌──────────────────────────────────────────────────┐
│                   MCP Client                     │
│             (Any MCP-capable client)             │
└──────────────────────┬───────────────────────────┘
                       │ stdio (JSON-RPC), HTTP (/mcp or /sse), or WebSocket
┌──────────────────────▼───────────────────────────┐
│               DeepADB Server                     │
│                                                  │
│  ┌─────────────────────────────────────────────┐ │
│  │           Tool Modules (49)                 │ │
│  │  device │ shell │ packages │ files │ logs   │ │
│  │  diagnostics │ ui │ build │ health          │ │
│  │  wireless │ control │ logcat-watch          │ │
│  │  forwarding │ screen-record │ emulator      │ │
│  │  testing │ multi-device │ snapshot          │ │
│  │  network-capture │ ci │ plugins │ baseband  │ │
│  │  accessibility │ regression                 │ │
│  │  device-farm │ registry │ at-commands       │ │
│  │  screenshot-diff │ workflow │ sensors       │ │
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "deepadb": { "command": "node", "args": ["/path/to/DeepADB/build/index.js"] } } }