Espresso MCP

意式浓缩咖啡

用于Espresso Android测试框架的MCP服务器，旨在提高测试能力并优化开发工作流程。

安装

• Python 3.x
• 紫外线： pip install uv

# Run in stdio mode
uvx espresso-mcp

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

用法

• 在Github Copilot上：将以下JSON配置添加到文件中 .vscode/mcp.json

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

• 在Claude上：将以下JSON配置添加到文件中 claude_desktop_config.json

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

• 使用OpenAI SDK

from openai import OpenAI

client = OpenAI()

resp = client.responses.create(
    model="gpt-4.1",
    tools=[
        {
            "type": "mcp",
            "server_label": "espresso-mcp",
            "server_url": "http://localhost:8000/sse",
            "require_approval": "never",
        },
    ],
    input="Open Teams App",
)

print(resp.output_text)

可用工具

以下工具可在 espresso-mcp 项目：

• list_avds：列出所有可用的Android虚拟设备（AVD）。
• list_模拟器：列出所有正在运行的Android模拟器。
• 启动模拟器：按名称启动Android模拟器。
• kill仿真器：杀死特定的Android模拟器。
• dump_ui层次结构：转储连接的Android设备的UI层次结构。
• open_uri：在连接的Android设备上打开URI。
• list_apps：列出连接的Android设备上安装的所有应用程序。
• 安装app：在连接的Android设备上安装APK。
• start_app：在连接的Android设备上启动特定应用程序。
• stop_app：停止连接的Android设备上的特定应用程序。
• 卸载app：从连接的Android设备卸载应用程序。
• clear_app_data：清除连接的Android设备上特定应用程序的应用程序数据。
• take_screenshot：截取已连接的Android设备的屏幕截图。
• record_screen：在指定的持续时间内记录连接的Android设备的屏幕。
• 按下按钮：模拟连接的Android设备上的按钮按下。
• 类型文本：在连接的Android设备上键入文本。
• clear_and_type_text：清除所有文本并在连接的Android设备上键入新文本。
• replace_text：通过清除当前文本并在连接的Android设备上键入新文本来替换文本。
• 轻敲：在特定坐标处模拟在连接的Android设备上点击。
• 滑动：在连接的Android设备上沿特定方向执行滑动手势。
• dump_当前活动：转储连接的Android设备的当前活动名称。

资源

以下资源可用：

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

______________________________________________________________________

本地设置

• Python 3.x
• 紫外线： 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检查器

# 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