mcp-server-adb

基本能力

产品定位

mcp-server-adb 是一个用于 Android 设备控制的 MCP 服务器，旨在通过 ADB 命令实现与 Android 设备的交互。

核心功能

1. 资源管理
2. 列出连接的设备
3. 获取设备信息
4. 查看已安装的包

5. 捕获屏幕截图

6. 设备控制

7. 连接/断开设备
8. 屏幕操作（点击、滑动、输入文本、按键）

9. 截图

10. 应用管理（即将推出）

11. 安装/卸载应用

12. 启动/停止应用

13. 设备分析

14. 分析设备状态和规格
15. 分析已安装的应用
16. 分析当前屏幕内容

适用场景

• Android 设备自动化测试
• 远程设备管理
• 应用调试和分析
• 设备状态监控

工具列表

1. Device Control
2. connect_device: 连接指定设备

3. disconnect_device: 断开设备连接

4. Device Operations

5. tap: 点击屏幕
6. swipe: 滑动屏幕
7. input_text: 输入文本
8. press_key: 按键

9. take_screenshot: 截图

10. Application Management (Coming Soon)

11. install_app: 安装 APK
12. uninstall_app: 卸载应用
13. start_app: 启动应用

14. stop_app: 停止应用

15. Prompts

16. analyze_device: 分析设备状态和规格
17. analyze_app_list: 分析已安装的应用
18. analyze_screen: 分析当前屏幕内容

常见问题解答

1. 如何启用 USB 调试？
2. 进入设置 > 关于手机
3. 点击“版本号”7 次以启用开发者选项
4. 进入设置 > 开发者选项

5. 启用“USB 调试”

6. 如何启用网络调试？

7. 首先通过 USB 连接设备
8. 在开发者选项中启用“无线调试”
9. 使用 connect_device 工具连接设备的 IP 地址

使用教程

使用依赖

1. Node.js 16 或更高版本
2. 安装 Android Debug Bridge (ADB) 并确保其在 PATH 中
3. 启用 USB 调试或网络 ADB 的 Android 设备

安装教程

1. 安装依赖

npm install

1. 构建服务器

npm run build

1. 开发时自动重建

npm run watch

1. 与 Claude Desktop 一起使用，添加服务器配置
2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-adb": {
      "command": "/path/to/mcp-server-adb/build/index.js"
    }
  }
}

调试方式

1. 使用 MCP Inspector 进行调试

npm run inspector

1. 检查设备连接状态

adb devices

1. 测试基本操作

adb shell input tap 100 100

许可证

该项目遵循 MIT 开源许可条款。