Skip to main content
Glama
deenesjakoruzh

espresso-mcp

by vs4vijay
GitHub
Python
MIT License
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

espresso-mcp

An MCP Server for the Espresso Android Test Framework, crafted to improve testing capabilities and optimize development workflows.

Installation

  • Python 3.x
  • uv: pip install uv
# Run in stdio mode uvx espresso-mcp # Run in sse mode uvx espresso-mcp --sse

Usage

  • On Github Copilot: Add below JSON config to the file .vscode/mcp.json
{ "servers": { "espresso-mcp": { "command": "uvx", "args": ["espresso-mcp"], "env": {} } } }
  • On Claude: Add below JSON config to the file claude_desktop_config.json
{ "mcpServers": { "terminal": { "command": "uvx", "args": ["espresso-mcp", "--timeout-ms", "30000"] } } }

Available Tools

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.

Resources

The following resources are available:

  • config://app: Retrieve static configuration data.
  • greeting://{name}: Get a personalized greeting.

Local Setup

  • 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

Debugging

  • Use MCP Inspector
# Install MCP Inspector yarn global add @modelcontextprotocol/inspector # Test MCP Server yarn run @modelcontextprotocol/inspector python server.py

Linting and Testing

# Lint uv run ruff check # Tests uv run pytest

Publishing

# Build the package uv build uv build --wheel uv build --no-sources # Upload to PyPI uv publish

Developement Notes

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
Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

espresso-mcp

  1. Installation
    1. Usage
      1. Available Tools
        1. Resources
          1. Local Setup
            1. Debugging
              1. Testing and Linting
                1. Publishing
                  1. Developement Notes

                Related MCP Servers

                • Playwright MCP Server

                  lebrodus
                  A
                  security
                  F
                  license
                  A
                  quality
                  A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
                  Last updated -
                  12
                  9,751
                  1

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/vs4vijay/espresso-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server