๐ค Why NeuralBridge?
Existing Android automation falls into two camps โ and both share the same bottleneck:
- Test frameworks (Appium, Maestro) โ built for QA, not AI agents. Every action routes through ADB or UIAutomator IPC, costing 200-1000ms per operation.
- MCP wrappers (mobile-mcp, droidrun) โ AI-aware, but thin ADB wrappers underneath. 200-2000ms per action.
NeuralBridge takes a different approach: an on-device AccessibilityService that executes actions in-process, eliminating IPC overhead entirely.
[!TIP] 100x faster on average โ NeuralBridge averages 6.4ms per action vs ~800ms for Appium and ~1.5s for mobile-mcp. See full benchmarks โ
๐๏ธ How It Works
Your AI agent speaks MCP over HTTP directly to the companion app โ no middleware, no ADB, no intermediate server.
[!NOTE] 1 hop, not 5. Appium routes through HTTP โ Appium Server โ ADB โ UIAutomator2 โ Device. NeuralBridge goes Agent โ HTTP โ Companion App. The AccessibilityService runs in-process โ like the difference between a phone call and a note on your own desk. Deep dive โ
๐ Quickstart
Prerequisites: Android SDK (API 24+), Java JDK 17, Android device or emulator (7.0+)
1๏ธโฃ Clone & Build
git clone https://github.com/dondetir/NeuralBridge_mcp.git
cd NeuralBridge_mcp/android
./gradlew assembleDebug
2๏ธโฃ Install & Enable
# Install the companion app
adb install -r app/build/outputs/apk/debug/app-debug.apk
# Enable AccessibilityService
adb shell settings put secure enabled_accessibility_services \
com.neuralbridge.companion/.service.NeuralBridgeAccessibilityService
adb shell settings put secure accessibility_enabled 1
[!IMPORTANT] Android 15+ requires an extra step: Settings โ Apps โ NeuralBridge โ Enable "Allow restricted settings"
3๏ธโฃ Connect Your AI Agent
The app shows its IP on the main screen. Add it to your agent's MCP config:
# Claude Code
claude mcp add neuralbridge http://<device-ip>:7474/mcp --transport http
{
"mcpServers": {
"neuralbridge": {
"type": "http",
"url": "http://<device-ip>:7474/mcp"
}
}
}
4๏ธโฃ Verify
Ask your AI agent: "Take a screenshot of the Android device" โ if you see a screenshot, you're connected! ๐
๐ Documentation
๐บ๏ธ Roadmap
-
Core MVP โ 16 tools, TCP protocol, basic gestures -
Advanced gestures, selectors, event streaming, notifications -
Semantic resolver, scroll-to-element, accessibility audit, screenshot diff - Multi-device, WebView tools, CI/CD integration, visual regression
๐ค Contributing
See CONTRIBUTING.md for guidelines. High-priority areas: additional MCP tools, performance optimizations, cross-platform support (iOS), and example demos.
๐ License
Apache 2.0 โ Copyright 2026 dondetir
"Powered by NeuralBridge"