bkerler/mtkclient
安全面向 MediaTek 设备的 Python 工具,可在 BROM 或 preloader 模式下利用 bootROM、读写闪存并修复手机。
项目介绍
MTKClient 是一个用 Python 编写的 MediaTek 设备工具。它让设备进入 BROM 或 preloader 模式,通过攻击 bootROM 来读写闪存分区并做修复。README 把它直接定位成「做利用、读写闪存和各种折腾」的 mtk 工具。
它覆盖多代联发科芯片。MT6781、MT6789、MT6855、MT6886、MT6895、MT6983、MT8985 等较新芯片使用 V6 协议,bootROM 已被修补,BROM 模式走不通,必须改用 preloader 模式,并通过 --loader 指定 Loaders/V6 目录中的匹配 loader 芯片说明。部分设备的 preloader 被关闭,可用 adb reboot edl 重新打开。
快速使用
- 按平台安装依赖和 USB 驱动。Linux/macOS 与 Windows 有各自的安装说明:Linux/macOS 安装、Windows 安装,另外还有一个 自动化 Windows 安装器。
- Windows 上必须安装联发科原厂 USB 端口驱动和 usbdk 驱动;Linux 一般只在用旧版 kamakiri 时才需要打补丁的内核,读写闪存不需要。
- 运行 mtk 脚本,关机后按住音量上 + 电源或音量下 + 电源并连接手机,工具识别到设备后松开按键。
- 对上面列出的 V6 芯片,不按硬件键、以 preloader 模式连接,并提供 loader:README 说明必须使用
--loader选项和Loaders/V6中的文件。 - 执行需要的操作,完整命令参考见 使用说明。
出错时加上 --debugmode 运行会生成 log.txt,求助时请附上日志和完整控制台输出 问题排查。
使用约束
- 上面列出的 V6 芯片不能靠 BROM 利用,必须使用 preloader 模式并配好 loader。
- Windows 需要联发科原厂端口驱动加 usbdk,工具才能识别设备。
- Linux 上旧版 kamakiri 需要打补丁的内核,读写闪存不需要。
- 项目以 GPL-3.0 发布,属于底层设备操作工具,应把它当作修复和利用工具来使用,而不是面向普通用户的刷机软件。
- USB VID/PID 自动识别配置在
config/usb_ids.py,芯片配置在config/brom_config.py芯片配置。
其他资源
项目还提供基于 Ubuntu 22.04 的 Live DVD,账号密码均为 user Live DVD,以及一份单独的 学习资料。
HotRepo 点评
MTKClient 是一个边界很窄的硬件利用与修复工具,并非通用刷机套件;README 也点明 V6 芯片会改变整个进入方式。该仓库在 2026-11-16 的 HotRepo Python 日榜上有记录,名次为第 14,当日新增 9 个 Star,全部语言日榜的最好名次尚无记录。这条单次快照只能说明它在 Python 榜上最近有一次不算高的露脸,现有同口径历史不足以判断趋势。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。