android-build-agent/
├─ profiles.json              # 项目清单（唯一需要你改的文件）
├─ pyproject.toml             # 可 pip install -e .
├─ README.md
└─ android_build_agent/
   ├─ config.py               # profiles 解析 + 任务白名单 + 路径推导
   ├─ toolchain.py            # JDK17 / Gradle / Android SDK 下载安装（跨平台、幂等）
   ├─ builder.py              # 拉源码、写受控 gradle.properties、跑 Gradle、收集 APK + sha256
   ├─ cli.py                  # list / install / build / artifacts
   └─ mcp_server.py           # MCP stdio 服务

<root>/
├─ toolchain/   jdk-17、gradle-<版本>、sdk
├─ gradle-home/ 依赖缓存（设 GRADLE_USER_HOME，不落 C 盘）
├─ tmp/         构建临时目录
├─ projects/<name>/  源码与 build/
├─ out/         APK + <name>-last-build.json（最近一次结果，供 Agent 读取）
└─ downloads/   安装包缓存（可删）

# 从 PyPI（发布后可用）
pip install android-build-agent

# 从源码（开发用）
pip install -e .

# 或者不装，直接跑
python -m android_build_agent.cli list --json
python -m android_build_agent.mcp_server

{
  "mcpServers": {
    "android-build": {
      "command": "python",
      "args": ["-m", "android_build_agent.mcp_server"],
      "cwd": "E:\\android-build\\android-build-agent"
    }
  }
}

{ "command": "android-build-agent-mcp", "args": [] }

{"name": "android_build", "arguments": {"profile": "shiye", "clean": true}}

{
  "ok": true, "exitCode": 0, "durationSec": 76.4,
  "apks": [{"path": "E:\\android-build\\out\\shiye-app-debug.apk", "size": 57147133,
            "sha256": "6c9eec…", "variant": "debug"}],
  "logTail": "BUILD SUCCESSFUL in 1m 15s"
}

android-build-agent list --json
android-build-agent install shiye --build --json
android-build-agent build shiye --clean --json
android-build-agent artifacts shiye --json

{
  "defaults": { "sdkPlatforms": ["android-33"], "buildTools": ["33.0.2"],
                "gradleVersion": "7.6.3", "task": "assembleDebug" },
  "projects": {
    "shiye": { "repo": "https://github.com/Tommyface/shiye-android.git", "branch": "main" },
    "myapp": { "repo": "https://github.com/me/myapp.git", "branch": "main",
               "sdkPlatforms": ["android-34"], "buildTools": ["34.0.0"], "gradleVersion": "8.7" },
    "bigapp": { "repo": "https://github.com/me/bigapp.git",
                "sdkPlatforms": ["android-35"], "buildTools": ["35.0.0"],
                "extraSdkPackages": ["ndk;26.1.10909125", "cmake;3.22.1"],
                "gradleVersion": "8.7", "task": ":app:assembleDebug" }
  }
}

你有 Android 构建能力，通过 android_* 工具调用。
- 先 android_list_profiles 看有哪些项目；
- 构建前若工具链未就绪，先 android_install_toolchain；
- 构建用 android_build(profile, clean?)，失败时看返回的 logTail / errorTail；
- 不要尝试传自定义 shell 命令，task 只能是 assembleDebug/assembleRelease/bundleRelease/lint 等。

python tests/test_config.py     # 14 个单测：任务白名单、profile 解析、路径派生、注入拦截
python tests/smoke_mcp.py       # 起真实 stdio 进程跑 MCP 握手 + 工具调用 + 安全拦截

git tag v1.0.1 && git push origin v1.0.1

pip install android-build-agent

pip install build
python -m build          # 产出 dist/android_build_agent-1.0.1-py3-none-any.whl 与 .tar.gz
python -m zipfile -l dist/android_build_agent-1.0.1-py3-none-any.whl