🧠 NeuralBridge
AI-native Android automation via the Model Context Protocol
Give any AI agent — Claude, GPT, Gemini, or your own — full control over an Android device.
Observe the UI. Tap. Swipe. Type. Manage apps. Capture screenshots.
All with sub-100ms latency. No root required.
______________________________________________________________________
🤔 为什么选择NeuralBridge？
现有的Android自动化分为两个阵营，两者都有相同的瓶颈：
- 测试框架 （Appium、Maestro）——为QA而不是AI代理构建。每个操作都通过ADB或UIAutomator IPC路由，每次操作花费200-1000ms。
- MCP包装 （移动mcp、droidrun）——AI感知，但下面有薄薄的ADB包装。每次动作200-2000毫秒。
NeuralBridge采用了一种不同的方法：一种执行操作的设备上可访问性服务 过程中的，完全消除IPC开销。
| 神经桥 | Appium | 大师 | 移动mcp | droidrun | ADB壳牌 | |
|---|---|---|---|---|---|---|
| ⚡ 点击延迟 | ~2ms | 300-1000ms | 750ms-2s | 500-2000ms | 200-1000ms | 300-1000ms |
| ⌨️ 文本输入 | ~1.4ms | 500-3000ms | 750ms-2s | 500-2000ms | 200-1000ms | 500-2000s |
| 🌳 UI树读取 | 18-33ms | 500-2000毫秒 | 750毫秒-2秒 | 1-5秒 | 200-500毫秒 | 1-5秒 |
| 📸 屏幕截图 | ~60ms | 300-5000ms | ~1s | 300-500ms | ~250ms | 300-500ms |
| 🔌 MCP本地 | 是 | 附加组件 | 是（stdio） | 是 | 通过适配器 | 否 |
| 🛠️ MCP工具 | 43 | 30+（附加） | 14+ | ~19 | ~11 | -- |
| 🎯 令牌优化 | 是（73%） | 否 | 否 | 否 |
\[！提示\] 平均快100倍 --神经桥平均值 6.4毫秒 每个动作vs ~800ms 对于Appium和 约1.5秒 对于移动mcp。 查看完整的基准测试→
______________________________________________________________________
🏗️ 运作原理
您的AI代理通过HTTP将MCP直接与配套应用程序通信，无需中间件、ADB或中间服务器。
\[！注意\] 一跳，不是五跳。 Appium通过HTTP路由→ Appium服务器→ ADB → UIAutomator2→ 设备。NeuralBridge成为特工→ HTTP → 配套应用程序。AccessibilityService在进程中运行，就像打电话和在自己桌子上写便条之间的区别。 深潜→
______________________________________________________________________
🚀 快速入门
先决条件： Android SDK（API 24+）、Java JDK 17、Android设备或模拟器（7.0+）
1.️⃣ 克隆和构建
git clone https://github.com/dondetir/NeuralBridge_mcp.git
cd NeuralBridge_mcp/android
./gradlew assembleDebug2.️⃣ 安装并启用
# 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\[！重要\] 安卓15+ 需要额外的步骤：设置→ Apps → 神经桥→ 启用 “允许受限设置”
3.️⃣ 连接您的AI代理
该应用程序在主屏幕上显示其IP。将其添加到代理的MCP配置中：
# Claude Code
claude mcp add neuralbridge http://:7474/mcp --transport http📋 Manual config (Claude Desktop / any MCP client)
{
"mcpServers": {
"neuralbridge": {
"type": "http",
"url": "http://:7474/mcp"
}
}
}4.️⃣ 验证
问你的AI代理： *“截取Android设备的屏幕截图”* --如果你看到屏幕截图，你就被连接了！ 🎉
______________________________________________________________________
📚 文档
| 文档 | 里面有什么 | |
|---|---|---|
| 🏗️ | 建筑 | 数据流、命令路径、选择器系统、限制 |
| 🛠️ | 工具参考 | 所有32个带有描述和延迟的MCP工具 |
| ⚡ | 演出 | 基准测试、架构比较、令牌优化 |
| 🔧 | 故障排除 | 连接问题、权限、屏幕截图、崩溃 |
| 🔨 | 发展 | 从源代码、项目结构、protobuf、日志构建 |
| 📱 | 应用程序 | 特定于应用程序的设置和权限 |
| 🤝 | 贡献 | 代码风格、公关流程、指导方针 |
| 🔒 | 安全 | 漏洞报告政策 |
______________________________________________________________________
🗺️ 路线图
- \[x\] ~~核心MVP——16个工具、TCP协议、基本手势~~
- \[x\] ~~高级手势、选择器、事件流、通知~~
- \[x\] ~~语义解析器、滚动到元素、可访问性审计、屏幕截图差异~~
- \[\]多设备、WebView工具、CI/CD集成、可视化回归
______________________________________________________________________
🤝 贡献
看 贡献.md 作为指导方针。高优先级领域：额外的MCP工具、性能优化、跨平台支持（iOS）和示例演示。
______________________________________________________________________
📄 许可证
Apache 2.0 --版权所有2026 dondetir
“由 神经桥"