AI导哈

Android测试框架服务器

Espresso Android测试框架的MCP服务器，用于提升测试能力和优化开发流程。

  • by vs4vijay
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vs4vijay/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

相关 MCP