eDBG MCP

March 27, 2026 · View on GitHub

概览

  • 手机端 eDBG 负责提供 HTTP MCP 服务
  • 主机端通过 adb forward 转发端口
  • 主机端 edbg-mcp-install 负责把 MCP 配置安装到各类 AI client
  • installer 是独立的 host-side 工具，不运行在手机上，也不会打包进 Android 目标二进制

默认 MCP 地址：

http://127.0.0.1:19810/mcp

使用

  1. 下载最新 Release 版本和对应平台的 installer
  2. 主机安装 mcp 工具：
./edbg-mcp-install --install
  1. 推送到手机并运行 mcp 模式
adb push eDBG /data/local/tmp
adb shell
su
chmod +x /data/local/tmp/eDBG
./data/local/tmp/eDBG --mcp

如果没有指定 --mcp-port，默认监听 19810。 4. 本地转发监听端口：

adb forward tcp:19810 tcp:19810

MCP 模式行为

  • --mcp 模式下会强制使用 -prefer uprobe -show-vertual，阉割了硬件断点相关功能和单步相关功能
  • 启动时不会预设任何启动断点
  • 默认进入待命状态，不会主动启动 app
  • 初始待命态下还没有目标；这时只应调用 attach(package, library) 选中目标
  • 选中目标但尚未启动 app 时，只允许 attach、break、info_break、info_file、断点管理，以及 run
  • MCP 暴露给 AI 的 break 内部始终按虚拟偏移处理，等价于 vbreak
  • attach 设置当前 package 和 library
  • run 直接启动当前目标 app，会执行 am start
  • continue 会阻塞等待，直到真正命中断点才返回
  • quit 只会清空当前 MCP 上下文并回到初始待命状态，不会退出 MCP server

Installer 构建

仓库里提供了独立的 installer Makefile：

make -f Makefile_installer current
make -f Makefile_installer all

产物目录：

bin/

默认会构建这些主流桌面平台版本：

  • darwin_amd64
  • darwin_arm64
  • linux_amd64
  • linux_arm64
  • windows_amd64
  • windows_arm64

Installer 用法

./edbg-mcp-install --list-clients
./edbg-mcp-install --install
./edbg-mcp-install --install --clients codex,cursor,claude
./edbg-mcp-install --project --install --clients cursor,vscode,zed
./edbg-mcp-install --config

如果你改了 --mcp-port，或者把本地转发端口改成了别的值：

./edbg-mcp-install --install --url http://127.0.0.1:23456/mcp

卸载配置：

./edbg-mcp-install --uninstall
./edbg-mcp-install --uninstall --clients codex,cursor

当前支持的 AI Client

可通过命令查看：

./edbg-mcp-install --list-clients

当前实现覆盖的主流客户端包括：

  • Claude
  • Claude Code
  • Cursor
  • VS Code
  • VS Code Insiders
  • Codex
  • Cline
  • Roo Code
  • Kilo Code
  • Windsurf
  • Zed
  • Gemini CLI
  • Qwen Coder
  • Copilot CLI
  • Amazon Q
  • LM Studio
  • Opencode
  • Warp
  • Kiro
  • Trae
  • Augment Code
  • Qodo Gen

说明

  • installer 会按不同 client 的配置格式分别写入 JSON 或 TOML
  • 对支持 project-level MCP 配置的 client，可以使用 --project
  • 全局安装默认只会修改已存在配置目录的 client，避免无意创建大量无关目录
  • Codex 会写入 ~/.codex/config.toml