Enhanced ADB MCP Server

用于Flutter/Android开发的增强型ADB MCP服务器

](https://badge.fury.io/py/r-adb-mcp-server)  

一个全面的MCP服务器，用于通过ADB控制Android设备，专为Flutter开发、UI测试和可视化QA工作流程而设计。

快速开始

# Install from PyPI
pip install r-adb-mcp-server

# Or run directly with uvx (no installation needed)
uvx r-adb-mcp-server

注： 包名和命令都是 r-adb-mcp-server.

然后添加到您的MCP客户端配置（Claude Desktop、Cursor等）-请参阅 配置 下面的部分。

特性

📱 设备管理

• 列出连接的设备及其详细信息
• 获取全面的设备信息（型号、Android版本、电池等）
• 带有DP计算的屏幕规格

📸 视觉捕捉

• 截图（base64或文件）
• 带启动/停止控制的屏幕录制
• 使用元数据捕获以进行Figma比较

🔍 UI检查

• 完整UI层次结构转储（XML）
• 按文本或资源ID查找元素
• 获取所有带有坐标的可点击元素
• 提取所有可见文本进行验证

🎯 输入与交互

• 轻击、双击、长按
• 滑动和滚动（向上/向下/到文本）
• 文本输入和清除
• 关键事件（主页、后退、回车等）
• 按文本或ID点击元素

📦 应用管理

• 启动/停止/清除应用程序
• 安装/卸载APK
• 列出具有过滤功能的包
• 获取当前活动
• 应用程序信息（版本、安装日期等）

🐛 调试和日志

• 带过滤的Logcat（标签、级别、包）
• Flutter特定日志
• 崩溃日志提取
• ANR痕迹

⚡ 性能分析

• 每个应用程序的内存使用情况
• CPU监控
• GPU渲染信息
• 用于检测jank的帧统计信息
• 电池统计

🌐 网络控制

• 网络信息（WiFi状态、IP）
• 切换WiFi/飞行模式
• 设置/清除HTTP代理

⚙️ 开发人员选项

• 动画比例（加速测试）
• 显示轻击（用于录制）
• 显示布局边界
• 屏幕旋转控制
• 更改分辨率/密度

♿ 可访问性测试

• 字体比例调整
• TalkBack切换
• 高对比度模式
• 颜色反转

📍 仿真器功能

• GPS位置欺骗
• 模拟短信/通话

先决条件

1. ADB已安装 在你的路径中

   adb version

1. 安卓设备/模拟器 已启用USB调试连接

   adb devices

1. Python 3.10+ 并且可选 uv 用于跑步 uvx

安装 uv （可选，用于 uvx 命令）：

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Or with Homebrew (macOS)
   brew install uv

   # Or with pip
   pip install uv

安装

来自PyPI（推荐）

# Install globally with pip
pip install r-adb-mcp-server

# Or use with uvx (no installation needed)
uvx r-adb-mcp-server

来源

cd adb-mcp-server

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

配置

克劳德桌面版

使用已安装的软件包（推荐）：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

或者，如果安装了pip：

{
  "mcpServers": {
    "adb": {
      "command": "r-adb-mcp-server"
    }
  }
}

使用来源：

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

光标IDE

添加到 .cursor/mcp.json:

使用已安装的软件包（推荐）：

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

使用来源：

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

克劳德代码

使用已安装的软件包（推荐）：

claude mcp add adb -- uvx r-adb-mcp-server

使用来源：

claude mcp add adb -- uv --directory /path/to/adb-mcp-server run python src/adb_mcp_server/server.py

GitHub Copilot

使用已安装的软件包（推荐）：

添加到您的VS代码设置(.vscode/settings.json 或用户设置）：

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

或者，如果安装了pip：

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "r-adb-mcp-server"
    }
  }
}

使用来源：

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

注： 确保您安装了GitHub Copilot Chat扩展，并在VS Code中启用了MCP支持。

可用工具（60+）

设备管理

视觉捕捉

UI检查

输入与交互

应用管理

调试和日志

演出

网络

开发人员选项

无障碍

文件和外壳

仅限模拟器

示例提示

基本用法

• “截取我手机的屏幕截图”
• “当前的屏幕分辨率和密度是多少？”
• “列出所有已安装的包含'flutter'的应用程序”
• “当前屏幕上显示什么？获取所有文本”

用户界面测试

• “找到登录按钮并点击它”
• “向下滚动，直到找到‘设置’”
• “获取所有可点击元素及其位置”
• “类型”test@email.com'进入当前领域”

调试

• “显示最后50个Flutter日志”
• “我的应用程序有崩溃日志吗？”
• “com.myapp的内存使用情况如何？”

视觉质量保证

• “捕获此屏幕以与Figma进行比较”
• “截图并告诉我UI结构”
• “将字体比例设置为1.3，并截图进行可访问性测试”

性能测试

• “将动画比例设置为0并运行应用程序”
• “获取我的应用程序的帧统计数据-有什么问题吗？”
• “GPU渲染性能如何？”

设备仿真

• “将屏幕更改为1080x1920以模拟较小的手机”
• “旋转到横向模式”
• “将位置设置为旧金山（37.7749，-122.4194）”

延伸

轻松添加新工具：

@mcp.tool()
def my_custom_tool(param: str, device_serial: str | None = None) -> str:
    """Description shown to AI"""
    return run_adb(["shell", "your-command", param], device_serial)

Flutter开发技巧

1. 加快测试速度：使用 set_animation_scale(0) 禁用动画
2. 视觉质量保证：使用 capture_screen_for_comparison() 使用Figma MCP
3. 调试日志: get_flutter_logs() 过滤器Flutter特定输出
4. 热重载：保持 flutter run 终端打开，使用设备进行交互
5. 响应式测试：使用 change_screen_size() 和 change_density()

许可证

麻省理工学院