espresso-mcp

A MCP Server for the Espresso Android Test Framework, designed to enhance testing capabilities and streamline development workflows.

uv tool install espresso-mcp

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

The following tools are available in the espresso-mcp project:

list_avds: List all available Android Virtual Devices (AVDs).
list_emulators: List all running Android Emulators.
start_emulator: Start an Android Emulator by name.
kill_emulator: Kill a specific Android Emulator.
dump_ui_hierarchy: Dump the UI hierarchy of the connected Android device.
open_uri: Open a URI on the connected Android device.
list_apps: List all installed apps on the connected Android device.
install_app: Install an APK on the connected Android device.
start_app: Start a specific app on the connected Android device.
stop_app: Stop a specific app on the connected Android device.
uninstall_app: Uninstall an app from the connected Android device.
clear_app_data: Clear app data for a specific app on the connected Android device.
take_screenshot: Take a screenshot of the connected Android device.
record_screen: Record the screen of the connected Android device for a specified duration.
press_button: Simulate a button press on the connected Android device.
type_text: Type text on the connected Android device.
tap: Simulate a tap on the connected Android device at specific coordinates.
swipe: Perform a swipe gesture in a specific direction on the connected Android device.

The following resources are available:

# 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 server.py

# Install MCP Inspector
yarn global add @modelcontextprotocol/inspector

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

uv run pytest

uv run ruff check

# Build the package
uv build

# Upload to PyPI
uv publish

uv init espresso-mcp

uv add "mcp[cli]"

uv run mcp dev server.py

uv tool run espresso-mcp

Playwright MCP Server