使用说明
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视图
按数字键可立即跳转到任何视图。
| 关键 | 视图 | 你能做什么 |
|---|---|---|
1 |
设备 | 连接、断开、无线切换、ADB版本显示 |
2 |
信息 | 硬件规格、电池、存储、网络、CPU一览 |
3 |
外壳 | 带有命令历史记录的交互式shell |
4 |
Logcat | 具有级别/标签/搜索过滤器和导出的实时日志流 |
5 |
文件 | 浏览文件系统、推送/拉取文件、管理权限 |
6 |
包裹 | 安装/卸载APK、管理权限、查看APK路径 |
7 |
端口转发 | TCP正向和反向端口规则 |
8 |
输入 | 点击、滑动、长按、按键事件、文本注入 |
9 |
过程 | 进程列表，按PID或名称终止，按应用程序内存信息 |
0 |
设置 | 读/写系统、安全和全局设置 |
- |
演出 | 实时CPU、内存、电池和显示指标 |
? 帮助· / 搜索· 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
| 类别 | 工具 |
|---|---|
| 设备 | list_devices device_info connect disconnect get_device_state is_rooted remount |
| 外壳 | shell root unroot |
| 包裹 | list_packages install_apk uninstall_package package_info force_stop clear_data enable_package disable_package grant_permission revoke_permission |
| 文件 | push_file pull_file list_files read_file write_file delete_file mkdir stat_file find_files disk_usage chmod chown |
| 屏幕 | screenshot screen_record get_screen_size |
| Logcat | logcat clear_logcat |
| 输入 | tap swipe key_event input_text long_press human_swipe |
| UI自动化 | get_ui_hierarchy find_element tap_element wait_for_element get_focused_app get_current_activity |
| 属性 | get_prop set_prop list_props |
| 端口转发 | forward forward_list forward_remove forward_remove_all reverse reverse_list reverse_remove_all |
| 意图 | start_activity send_broadcast open_url |
| 活动 | get_current_activity list_activities |
| 系统 | reboot get_battery |
| 连接性 | wifi_control get_ip_address get_network_info tcpip_mode usb_mode ping_host |
| 设置 | get_setting put_setting list_settings delete_setting |
| 设备控制 | screen_on screen_off is_screen_on get_brightness set_brightness set_rotation set_auto_rotation get_airplane_mode set_airplane_mode |
| 音量和媒体 | volume_up volume_down volume_mute media_play media_pause media_next media_previous |
| 显示 | set_display_size reset_display_size set_density reset_density get_font_scale set_font_scale |
| 通知 | list_notifications expand_notifications collapse_notifications expand_quick_settings |
| 过程 | list_processes kill_process kill_process_by_name top_processes memory_info app_memory_info |
| 转储系统 | dumpsys dumpsys_list battery_info display_info window_info |
| 安全 | selinux_status set_selinux list_permissions get_apk_path |
| 测试 | run_monkey run_instrumentation |
| 电池模拟 | simulate_battery reset_battery |
| 备份 | bugreport sideload backup restore |
| 网络 | netstat |
| 剪贴板 | get_clipboard set_clipboard |
命令行命令
将adb-tui用作可脚本化的CLI，而无需启动tui：
adb-tui devices # List connected devices
adb-tui shell <serial> <command> # Run shell command
adb-tui screenshot <serial> output.png # Capture screenshot
adb-tui install <serial> 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
