エスプレッソ-MCP

テスト機能を強化し、開発ワークフローを合理化するように設計された、Espresso Android テスト フレームワーク用の MCP サーバーです。

インストール

• Python 3.x

• uv: pip install uv

uv tool install espresso-mcp

Related MCP server: pdf-tools-mcp

使用法

• Claudeの場合: 以下のJSON設定をclaude_desktop_config.jsonファイルに追加します。

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

利用可能なツール

espresso-mcpプロジェクトでは次のツールが利用できます。

• list_avds : 利用可能なすべての Android 仮想デバイス (AVD) を一覧表示します。

• 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 デバイスのタップをシミュレートします。

• スワイプ: 接続された Android デバイスで特定の方向にスワイプ ジェスチャを実行します。

リソース

利用可能なリソースは次のとおりです。

• config://app : 静的な構成データを取得します。

• greeting://{name} : パーソナライズされた挨拶を取得します。

ローカルセットアップ

• Python 3.x

• uv: pip install uv

# Install
uv install

# Run Dev Mode
uv run mcp dev server.py

デバッグ

• MCPインスペクターを使用する

# Install MCP Inspector
yarn global add @modelcontextprotocol/inspector

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

テスト

uv run pytest

出版

# Build the package
uv build

# Upload to PyPI
uv publish

開発ノート

uv init espresso-mcp

uv add "mcp[cli]"

uv run mcp dev server.py