A.R.T MCP Server
Provides tools for Android ROM development and modification, including importing, unpacking, and repacking ROM ZIPs, payload.bin, super images, IMG, WIN, and DAT/DAT.BR files; synthesizing super images; and converting RAW/Sparse images.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Android ROM Toolkit for Windows
当前版本:v1.2.10
v1.2.10 更新
Windows 原生解包支持保留 Android 文件系统中仅大小写不同的目录和文件名。
改进重复解包、覆盖发布和回包失败时的暂存产物清理与恢复。
回包失败时显示底层构建工具返回的错误信息。
介绍
一个面向 Windows 的 Android ROM 工具,简称 A.R.T。本项目基于原作者 ELF-RC 的 A.R.T 开源项目重构和扩展,保留原项目的许可证与致谢信息,现提供 Windows 图形界面、CLI 和 MCP 接口。
运行平台
Windows 10/11 x64:默认使用 Windows 原生工具及 EXE 内置的 AVB 工具。常规操作不会启动 WSL;只有 OTA 扩展参数需要内置兼容 avbroot 时,才会按需通过
wsl.exe调用它。完整 WSL 后端仍需在工具链页明确选择并保存,或设置ART_BACKEND=wsl。Linux x86_64/arm64:继续使用原有 ELF 工具和 CLI 流程。
Windows 原生工具目录可通过
ART_WINDOWS_TOOLS指定,例如E:\\MIO-KITCHEN-4.1.3-win\\bin\\Windows\\AMD64。
注意事项
非必要请不要授予工具SU ! ! !
请勿删除【工程目录/configs文件夹】,打包时所需的文件信息都在此处
工程路径建议使用英文和数字;GUI 支持 Unicode 输入。若第三方工具或 WSL 不接受 Unicode 路径,请将工程放在英文目录。
启动方式
python Scripts/main.py --gui # 现代桌面界面
python Scripts/main.py --mcp # MCP stdio 服务
python Scripts/main.py # 原有 CLIGUI 使用 PySide6/Qt 的原生桌面工作台,浅色主题为默认,可在“工具链 → 界面外观”中切换浅色/深色;主题偏好会保存到 art-res/ui-settings.json。图形界面覆盖 ROM ZIP、payload、super、IMG、WIN、DAT/DAT.BR 的导入、解包和回包,并提供 super 合成、RAW/Sparse 转换和工具链诊断。Windows 发布包使用 art-res/bin-win-amd64 中的原生工具;缺失的可下载工具可以在“工具链”页自动补齐。EXT4 校验工具 e2fsck.exe、resize2fs.exe 及依赖 DLL 放在独立的 e2fsprogs 子目录,通过 Cygwin Windows 运行库运行,无需 WSL。使用的 Windows 移植版为 1.44.5,若镜像采用该版本不支持的新特性,校验会明确失败,不会跳过或隐式切换到 WSL。MCP 工具包含同一套工程、导入、解包、回包和 super 合成功能。
Windows 打包:
python build.py产物为 A.R.T-Windows-amd64.zip,解压后双击 art.exe 即可启动工作台,不会额外打开终端窗口。后台任务日志仍显示在界面中,--mcp 继续通过标准输入输出管道通信。
Windows AVB 与 OTA 签名
avbtool基于 AOSP 1.3.0,连同 RSA 签名库内嵌到art.exe。签名、验签、镜像信息和去除 footer 无需另装 Python、OpenSSL 或 WSL。源码运行需安装requirements.txt。“高级工具 → AVB 镜像签名”可选择无签名、内置 RSA2048 测试密钥、内置 RSA4096 测试密钥(默认)或自定义 PEM;RSA 算法自动匹配密钥位数。内置测试私钥随源码及 EXE 公开提供,正式发布签名请使用自己的密钥。
原生哈希树签名默认生成 AVB 内嵌 FEC。AOSP
avbtool的 FEC 数据由随包的avbroot fec generate生成,格式、交错布局和 roots 参数与 Androidfec工具一致;--do_not_generate_fec仍可显式关闭。自动大小基于镜像逻辑大小计算并为哈希树、FEC 与 AVB footer 预留空间。发布包附带官方 Windows x64
avbroot 3.34.1。缺失时在首次运行相应操作或“自动补齐 Windows 工具”中查询官方最新稳定版,验证 SHA256 与实际版本后安装。发布包同时保留原项目的扩展 avbroot 构建。OTA 使用
--add-partition、--disable-avb或原版--super-mode时,Windows 原生后端会自动调用这个内置兼容工具(--super-mode NAME会转换为动态分区标记);普通 OTA 替换、AVB 和 FEC 仍走 Windows 原生工具。扩展构建通过随包的art-res/bin-amd64/avbroot运行,Windows 需要启用wsl.exe,无需在工具链页切换后端。深浅色主题统一下拉列表的边框、文本、选中背景及禁用状态;签名失败会保留工具错误信息。
可用 art.exe --avbtool version 检查内置工具。发布前的真实工具检查:
python -m unittest discover -s tests -v
python tests/native_ext4_smoke.py path/to/art.exe
python tests/native_avb_smoke.py path/to/art.exe工具预览
工程目录结构
DNA_工程名/
├── INPUT/ # 原始输入区:放置 img、payload.bin、new.dat、br、win 等文件
├── OUT/ # 最终输出区:合成的 img、new.dat、br、super.img、修补后的 boot 镜像
└── WORKSPACE/ # 可编辑工作区
├── config/ # 分区 fsconfig、SELinux contexts、镜像信息等合成 metadata
├── system/
├── vendor/
└── 其他分区目录/INPUT是只读输入区:工具不会主动删除、改名或覆盖其中的文件;所有中间文件写入WORKSPACE分区文件树与
config均位于WORKSPACE/,请勿手动删除WORKSPACE/config/中需要回包的 metadata最终合成产物输出到
OUT/
回包 metadata 自动补齐
新增或修改过的文件在回包时会自动补上缺失的合成 metadata,无需手写整条规则:
fsconfig:缺失的路径按目录0755、文件0644(可执行目录下的二进制0755、*.sh0750)补齐SELinux contexts:为没有专属规则的路径补一行标签,继承顺序为.prop、.rc、.xml、.conf、.cfg、.ini、.json等配置文件,继承同目录同类配置文件的标签其他文件继承同目录常规文件的标签
目录继承同目录目录、再逐级向上继承父目录的标签
补齐的行追加在
WORKSPACE/config/<分区>_contexts.txt末尾(libselinux取最后一条匹配,因此它会覆盖分区级兜底规则),并回写到工程文件标签不理想时直接编辑该文件对应行再回包即可,无需从路径开始重写上下文规则
构建
1.安装python3,pip
2.pip install -r requirements.txt --break-system-packages (这里更推荐使用虚拟环境)
3.执行./build.py构建
反馈
请直接提issue
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP for Android CLI agent build gate, structured receipts, audit logs, and reviewer-ready evi
Project management shared by people and AI agents, with persistent project state through MCP.
A MCP server built for developers enabling Git based project management with project and personal…
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides a one-stop automated solution for Android APK security analysis by integrating tools like JEB, JADX, APKTOOL, FlowDroid, and MobSF into unified MCP standard API interfaces.11-
- AlicenseAqualityAmaintenanceEnables Android APK reverse engineering and Flutter runtime injection through a six-step pipeline of decompile, analyze, synthesize, inject, patch, and repackage. Provides MCP tools for authorized security research and penetration testing.943 npm5MIT
- AlicenseNot gradedqualityBmaintenanceProvides AI agents with a unified MCP interface for Android APK reverse engineering, metadata analysis, Smali/resource editing, rebuilding, signing, verification, and ADB device testing.MIT
- AlicenseAqualityCmaintenanceProvides MCP tools to validate ROMs, extract and pack N64 game assets, export code/headers, import modded assets, and render audio sequences via HarbourMasters/Torch.12MIT