espresso-mcp
2025.05.09
0
PythonAndroid 测试自动化测试开发工具开发效率
espresso-mcp 是一个为 Espresso Android 测试框架设计的 MCP 服务器，旨在增强测试能力并简化开发工作流程。它提供了一系列工具来管理 Android 虚拟设备、模拟器以及与 Android 设备交互的功能。
View on GitHub
Overview
产品定位
espresso-mcp 是一个专为 Android 测试设计的 MCP 服务器，主要用于增强 Espresso 测试框架的功能，提供更高效的测试和开发体验。
核心功能
- 管理 Android 虚拟设备 (AVDs) 和模拟器
- 与 Android 设备交互（安装/卸载应用、启动/停止应用等）
- 设备屏幕操作（截图、录屏、点击、滑动等）
- 获取设备 UI 层次结构
- 提供静态配置数据和个性化问候资源
适用场景
- Android 应用自动化测试
- 开发过程中的快速调试
- 持续集成/持续部署 (CI/CD) 流程
- 质量保证团队的测试自动化
工具列表
- list_avds: 列出所有可用的 Android 虚拟设备
- list_emulators: 列出所有运行的 Android 模拟器
- start_emulator: 按名称启动 Android 模拟器
- kill_emulator: 终止特定 Android 模拟器
- dump_ui_hierarchy: 获取连接设备的 UI 层次结构
- open_uri: 在设备上打开 URI
- list_apps: 列出设备上安装的所有应用
- install_app: 在设备上安装 APK
- start_app: 启动特定应用
- stop_app: 停止特定应用
- uninstall_app: 卸载应用
- clear_app_data: 清除应用数据
- take_screenshot: 截取设备屏幕
- record_screen: 录制设备屏幕
- press_button: 模拟按钮按下
- type_text: 输入文本
- tap: 在特定坐标模拟点击
- swipe: 在特定方向执行滑动操作
常见问题解答
无明确常见问题解答部分
使用教程
使用依赖
- Python 3.x
- 安装 uv:
pip install uv
安装教程
uv tool install espresso-mcp
调试方式
- 使用 MCP Inspector:
yarn global add @modelcontextprotocol/inspector
yarn run @modelcontextprotocol/inspector python server.py
- 测试和代码检查:
uv run pytest
uv run ruff check
本地开发设置
# 安装依赖
uv sync
# 或
uv sync --frozen --all-extras --dev
# 运行服务器
uv run espresso-mcp
# 开发模式运行
uv run mcp dev server.py
发布
# 构建包
uv build
# 上传到 PyPI
uv publish