| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| ComposeBridge v0.4.0 -- MCP Server for AI Agents source code.tar.gz | 2026-09-30 | 201.8 kB | |
| ComposeBridge v0.4.0 -- MCP Server for AI Agents source code.zip | 2026-09-30 | 271.9 kB | |
| README.md | 2026-09-30 | 3.5 kB | |
| Totals: 3 Items | 477.2 kB | 0 | |
π v0.4.0 β MCP Server for AI Agents
ComposeBridge now ships with a standalone MCP Server that lets AI agents (Claude Desktop, Antigravity IDE, Cursor, Cline) edit Jetpack Compose code surgically β without needing the phone.
π What's New
π€ MCP Server (Model Context Protocol)
A new standalone server that exposes Compose-aware tools to any MCP-compatible AI client.
3 tools available:
| Tool | Description |
|---|---|
find_token_by_color |
Reverse lookup: hex β token name |
set_token |
Surgically edit a token value (single-line diff) |
rollback_last |
Undo last edit (persistent across restarts) |
Key feature: Works independently of the phone.
- β No
adb reverse - β No WebSocket bridge
- β No running app
- β Just Python + AI client + Compose project
π Documentation
- Full MCP Guide: docs/mcp-guide.md
- Updated README: new MCP section with setup for both Antigravity + Claude Desktop
π Persistent Journal
Every edit is journaled to .composebridge-journal.json.
Rollback works even after process restarts.
β¨ All Features (cumulative)
- π― Live Design Mode β tap any Composable to inspect
- π¨ Live Color Editing β <50ms latency
- π Live Dimension Editing β sliders on device
- πΎ File Persistence β single-line git diff
- π Rebuild Persistence β changes are permanent
- π§© Dynamic UI Compiler β JSON β Compose screens
- π³ Runtime Tree Navigation β parent β children
- π€ MCP Server β AI agent integration (NEW)
- π Token Auth β WebSocket handshake verification
- π Journal Rollback β persistent across restarts
- π UTF-16 β UTF-8 Mapper β 100% accuracy
- π«
.bridgeignoreβ never touch generated code
π§ͺ Verified
Tested end-to-end in Antigravity IDE: User: @composebridge set_token("welcomeCardHeight", "300")
Result in AppDimens.kt:
val welcomeCardHeight: Dp get() = BridgeDimensionRegistry.get("welcomeCardHeight", 240.dp)
val welcomeCardHeight: Dp get() = BridgeDimensionRegistry.get("welcomeCardHeight", 300.dp)
text
β Single-line git diff β Rollback works β No phone connected
π¦ What's Included
- CLI β Generate Android projects from JSON schemas
- Agent β Android runtime library (
:composebridge-agent) - Server β Python WebSocket daemon + AST source splicer
- MCP Server β AI agent integration (NEW in v0.4.0)
- Example β StudentApp reference project
β Compatibility
| Component | Version |
|---|---|
| Kotlin | 2.1.20+ |
| Jetpack Compose | 1.7.3+ |
| Gradle | 8.5+ |
| AGP | 8.5+ |
| Min SDK | 24 |
| Python | 3.10+ |
| MCP SDK | 2.2.0+ |
π Quick Start (MCP)
:::bash
# 1. Install
cd server
pip install -r requirements.txt
# 2. Configure your AI client (Antigravity)
# Edit: ~/.gemini/config/mcp_config.json
{
"mcpServers": {
"composebridge": {
"command": "python",
"args": ["C:\\path\\to\\composebridge-en\\server\\mcp_server.py"]
}
}
}
# 3. Use from AI chat
@composebridge set_token("welcomeCardHeight", "300")
Full guide: [docs/mcp-guide.md](https://docs/mcp-guide.md)
π License
Apache 2.0