Aiphone MCP

aiphone mcp

MCP服务器，用于通过ADB控制Android设备。展示用于屏幕截图、UI交互、应用程序管理、无线ADB和设备诊断的工具。

适用于任何兼容MCP的客户端：LM Studio、Claude Desktop、Cursor、Windsurf。

______________________________________________________________________

特性

• 自动压缩的屏幕截图（WebP、JPEG、PNG）
• UI检查——点击、滑动、键入、按选择器查找元素
• 应用程序控制——启动、停止、安装检查、打开URL
• 基于TCP/IP的无线ADB
• 设备信息——电池、内存、存储、网络接口
• 导航——主页、后退、最近、屏幕旋转
• 通知——发布和检查系统通知
• 连接性——切换WiFi、移动数据、飞行模式
• 断言——前台应用程序和元素存在性检查
• 逃生舱——任意运行 adb shell 命令

______________________________________________________________________

需求

• Node.js 18+
• 安卓调试桥 在你的路径中
• 启用USB调试的Android 8+

要启用USB调试：设置→ 关于手机→ 点击“内部版本号”7次→ 开发人员选项→ USB调试。

______________________________________________________________________

安装

npx （无需安装）：

npx aiphone-mcp

全局安装:

npm install -g aiphone-mcp

本地克隆:

git clone 
cd aiphone-mcp
npm install
npm link

______________________________________________________________________

客户端配置

所有客户端都使用相同的配置结构。入口点是 npx aiphone-mcp.

{
  "aiphone": {
    "command": "npx",
    "args": ["aiphone-mcp"]
  }
}

______________________________________________________________________

配置

{
  "aiphone": {
    "command": "npx",
    "args": ["aiphone-mcp"],
    "env": {
      "AIPHONE_ADB_PATH": "/usr/local/bin/adb", 
    }
  }
}

______________________________________________________________________

可用工具

设备

屏幕观察

交互

元素选择器

导航

应用程序控制

无线ADB

通知

连接性

逃生舱口

______________________________________________________________________

屏幕截图参数

图像永远不会被放大。

______________________________________________________________________

选择器

定位元素的工具接受 selector 具有以下字段的对象：

优先： resourceId > text > contentDesc > className.

______________________________________________________________________

故障排除

未找到设备 --检查USB调试是否已启用，设备是否已授权。跑 adb devices 以验证。

找不到adb --确保 adb 在您的路径中，或已设置 AIPHONE_ADB_PATH 到完整的二进制路径。

无线连接失败 --两台机器必须位于同一网络上。运行 enable_wireless_adb 当USB仍然连接时，使用以下命令获取IP get_device_ip，然后致电 adb_connect.

屏幕截图太大 --使用 max_width: 720, format: "webp" 以减小输出尺寸。

______________________________________________________________________

许可证

MIT。看 许可证 全文。