Adb Tui

adb-tui

Android meets AI. From your terminal.

A full-featured terminal UI and MCP server for Android Debug Bridge.

Control any Android device with keystrokes, or let AI do it for you.

Install · Views · MCP + AI · CLI · 中文文档

______________________________________________________________________

adb tui 在一个终端窗口中为您提供完整的Android调试仪表板。11个交互式视图，每个视图只需一键即可。无需记忆命令，无需解析输出。

它还兼作 配备120多种工具的MCP服务器将任何Android设备变成AI可控的端点。Claude或任何兼容MCP的代理都可以自主安装应用程序、流式日志、捕获屏幕、管理文件等。

亮点

• 亚行全面覆盖：设备、shell、logcat、文件、包、进程、端口、输入、设置、性能
• 人工智能原生：用于Claude和其他AI代理的内置MCP服务器（stdio+HTTP/SSE）
• 实时日志：流，按级别/标签/PID过滤，搜索，导出，处理10k+个条目
• 无线调试：USB和TCP/IP之间的一键切换
• 安全：所有shell命令都使用参数化执行，没有注入向量
• 跨平台：macOS、Linux、Windows。任何兼容ADB的Android设备或模拟器
• 零配置：安装并运行

安装

macOS（自制）

brew install alanisme/tap/adb-tui

Linux/macOS（脚本）

curl -fsSL https://raw.githubusercontent.com/alanisme/adb-tui/main/install.sh | sh

Windows（PowerShell）

irm https://raw.githubusercontent.com/alanisme/adb-tui/main/install.ps1 | iex

走

go install github.com/alanisme/adb-tui/cmd/adb-tui@latest

来源

git clone https://github.com/alanisme/adb-tui.git
cd adb-tui
make build

GitHub 发布

上所有可用平台的预构建二进制文件 发布 页面。

先决条件： ADB必须安装在您的PATH中。

TUI视图

按数字键可立即跳转到任何视图。

? 帮助· / 搜索· Tab 循环视图· j/k 导航· T 主题· q 退出（确认）· ^c 退出

MCP服务器和AI集成

adb tui 实现 模型上下文协议，将您的Android设备变成AI代理的配备工具的端点。

这意味着Claude或任何兼容MCP的客户端都可以：

• 安装和管理应用程序
• 读取并过滤日志输出
• 推/拉文件、截图、录制屏幕
• 控制触摸输入和按键事件
• 查询设备信息、电池、网络状态
• 管理系统设置和权限

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "adb": {
      "command": "adb-tui",
      "args": ["mcp"]
    }
  }
}

HTTP/SSE传输

adb-tui mcp --transport http --addr :8080

所有120+MCP工具

Expand full tool list

命令行命令

将adb-tui用作可脚本化的CLI，而无需启动tui：

adb-tui devices                           # List connected devices
adb-tui shell            # Run shell command
adb-tui screenshot  output.png    # Capture screenshot
adb-tui install  app.apk         # Install APK
adb-tui mcp                              # Start MCP server (stdio)
adb-tui version                          # Print version info

配置

可选。地点： ~/.config/adb-tui/config.json:

{
  "adb_path": "/usr/local/bin/adb",
  "theme": "default"
}

可用主题： default, nord, tokyonight, catppuccin。您还可以通过按在应用程序中切换主题 T.

用例

• Android应用程序调试：流式日志，检查UI层次结构，在不离开终端的情况下切换设置
• 设备车队管理：连接多个设备，在一个仪表板中查询电池/存储/网络
• 自动化测试：运行monkey测试，使用驱动UI tap_element/find_element，捕获屏幕截图
• 人工智能设备控制：与Claude或任何MCP客户端配对，构建自主的Android工作流程
• 远程设备检查：用于无头或CI环境的无线ADB+HTTP/SSE传输
• 逆向工程：浏览文件系统，转储窗口信息，检查正在运行的进程和权限

建筑

cmd/adb-tui/       CLI entry point (cobra)
internal/adb/       ADB client library, parameterized, concurrent, tested
internal/tui/       Bubbletea TUI, 11 views, Elm architecture
internal/mcp/       MCP server, 120+ tools, stdio + HTTP/SSE transport
internal/config/    Configuration management
pkg/jsonrpc/        JSON-RPC 2.0 implementation

贡献

欢迎捐款。看 贡献.md 作为指导方针。

make check    # fmt, vet, lint, test with race detector
make ci       # full CI pipeline with coverage gate

许可证

阿帕奇-2.0 © 艾伦