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