Espresso MCP

🚀 espresso-mcp

espresso-mcp 是一款专为 Espresso Android 测试框架打造的 MCP 服务器，旨在提升测试能力，优化开发工作流程。

🚀 快速开始

请参考后续的安装指南和使用示例，以快速使用 espresso-mcp 。

✨ 主要特性

• 为 Espresso Android 测试框架提供支持，增强测试能力。
• 提供丰富的工具，可对 Android 设备进行多种操作。
• 支持在不同平台（如 Github Copilot、Claude）上进行配置使用。

📦 安装指南

环境要求

• Python 3.x
• 安装 uv：pip install uv

运行命令

标准输入输出模式

# Run in stdio mode
uvx espresso-mcp

SSE 模式

# Run in sse mode
uvx espresso-mcp --sse

💻 使用示例

在 Github Copilot 上使用

在 .vscode/mcp.json 文件中添加以下 JSON 配置：

{
  "servers": {
    "espresso-mcp": {
      "command": "uvx",
      "args": ["espresso-mcp"],
      "env": {}
    }
  }
}

在 Claude 上使用

在 claude_desktop_config.json 文件中添加以下 JSON 配置：

{
  "mcpServers": {
    "terminal": {
      "command": "uvx",
      "args": ["espresso-mcp", "--timeout-ms", "30000"]
    }
  }
}

📚 详细文档

可用工具

espresso-mcp 项目提供了以下工具：

• list_avds：列出所有可用的 Android 虚拟设备（AVDs）。
• list_emulators：列出所有正在运行的 Android 模拟器。
• start_emulator：按名称启动一个 Android 模拟器。
• kill_emulator：关闭指定的 Android 模拟器。
• dump_ui_hierarchy：导出已连接 Android 设备的 UI 层级结构。
• open_uri：在已连接的 Android 设备上打开一个 URI。
• list_apps：列出已连接 Android 设备上所有已安装的应用。
• install_app：在已连接的 Android 设备上安装一个 APK。
• start_app：在已连接的 Android 设备上启动指定的应用。
• stop_app：在已连接的 Android 设备上停止指定的应用。
• uninstall_app：从已连接的 Android 设备上卸载一个应用。
• clear_app_data：清除已连接 Android 设备上指定应用的应用数据。
• take_screenshot：对已连接的 Android 设备进行截图。
• record_screen：对已连接的 Android 设备进行指定时长的屏幕录制。
• press_button：模拟在已连接的 Android 设备上按下按钮。
• type_text：在已连接的 Android 设备上输入文本。
• tap：模拟在已连接的 Android 设备上指定坐标处进行点击。
• swipe：在已连接的 Android 设备上执行指定方向的滑动手势。

可用资源

以下资源可供使用：

• config://app：检索静态配置数据。
• greeting://{name}：获取个性化问候语。

🔧 技术细节

本地设置

环境要求

• Python 3.x
• 安装 uv：pip install uv

安装依赖

# Install dependencies
uv sync
# OR
uv sync --frozen --all-extras --dev

运行服务器

# Run Server
uv run espresso-mcp

开发模式运行

# Run in Dev Mode
uv run mcp dev src/espresso_mcp/server.py

调试

使用 MCP Inspector 进行调试：

# Install MCP Inspector
yarn global add @modelcontextprotocol/inspector

# Test MCP Server
yarn run @modelcontextprotocol/inspector python server.py

代码检查和测试

# Lint
uv run ruff check

# Tests
uv run pytest

发布

# Build the package
uv build
uv build --wheel
uv build --no-sources

# Upload to PyPI
uv publish

开发注意事项

uv tool install espresso-mcp

# OR

uvx espresso-mcp

uv init espresso-mcp

uv add "mcp[cli]"

uv run mcp dev server.py

uv tool run espresso-mcp

uv run pre-commit install

pre-commit run --all-files