AI导哈

Android自动化控制工具

NeuralBridge是一个AI原生的Android自动化工具，通过Model Context Protocol（MCP）让AI代理（如Claude、GPT、Gemini等）直接控制Android设备，实现低延迟的UI操作（点击、滑动、输入等）。

  • by dondetir
  • Kotlin
  • 本地部署
  • 44 星标
  • 更新于
在 GitHub 查看 dondetir/NeuralBridge_mcp

使用说明

🧠 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自动化分为两个阵营，两者都有相同的瓶颈：

  1. 测试框架 （Appium、Maestro）——为QA而不是AI代理构建。每个操作都通过ADB或UIAutomator IPC路由，每次操作花费200-1000ms。
  2. 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 assembleDebug

2.️⃣ 安装并启用

# 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://<device-ip>:7474/mcp --transport http
📋 Manual config (Claude Desktop / any MCP client) 
{
  "mcpServers": {
    "neuralbridge": {
      "type": "http",
      "url": "http://<device-ip>: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

“由 神经桥"

相关 MCP