Android Build AI SDK

A pure Python SDK providing a stateless, Model Context Protocol (MCP) compliant interface for AI Agents to interact with the Android Build System and the CLI tools (Soong, Ninja, aconfig, etc.).

Features

• Stateless Environment Management: Automatically captures and caches envsetup.sh and lunch results. No manual environment sourcing required.
• MCP & JSON-RPC 2.0 Compliant: Supports standard tool discovery, batch requests, and progress notifications.
• Structured Build Outcomes: Build results (including compilation failures) are returned as data objects rather than exceptions, allowing the Agent to programmatically analyze logs and exit codes.
• Dynamic Tool Discovery: The tool list is generated at runtime from a central registry. Adding new build system capabilities is as simple as defining a new function and registering it with a decorator.
• Isolated Testing: Unit tests run using mocks and temporary OUT_DIR redirection to avoid workspace pollution.
• No External Dependencies: Uses only the Python standard library.

Project Structure

android_build/
├── api/                # Layer 1: Core Build System APIs
│   ├── build.py        # Build execution, progress parsing, and structured log analysis
│   ├── config.py       # Build variables and aconfig queries
│   ├── env.py          # Environment snapshotting and BuildContext
│   ├── module.py       # module-info.json parsing and cache management
│   └── ninja.py        # Ninja graph queries, dependency analysis, and command retrieval
├── interface/          # Layer 2: MCP/CLI Interface
│   ├── cli.py          # Unified entry point and server daemon
│   ├── server.py       # JSON-RPC 2.0 Server with Batch/Progress support
│   ├── registry.py     # Tool registration and discovery logic
│   └── schema.py       # Auto-generation of JSON schemas from dataclasses
├── tests/              # Isolated Unit Tests
├── settings.json       # Portable MCP configuration template
└── run_tests.sh        # Test execution script

Setup & Registration

Automatic Registration (Recommended)

This SDK is integrated into the standard Googlers' developer workflow. When launching the shared MCP server, the SDK is automatically available as the MCP tools.

Manual Registration

If you need to register the server manually (e.g., for an external MCP client or troubleshooting), use the built-in helper:

1. Generate the registration command:

   python3 interface/cli.py --print-registration-cmd
   

2. Execute the output command: The output will follow the correct positional syntax:

   gemini mcp add android_build python3 '/path/to/cli.py' -e PYTHONPATH='/path/to/sdk' --trust
   

Manual Usage (Server Mode)

You can interact with the server manually via stdin/stdout:

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | python3 interface/cli.py

Development & Testing

To run the full suite of isolated unit tests:

source build/envsetup.sh && lunch <lunch product> && atest -c build_sdk_lib_test