Espresso MCP

🚀 espresso-mcp

Espresso Androidテストフレームワーク用のMCPサーバーです。テスト機能を向上させ、開発ワークフローを最適化するために設計されています。

🚀 クイックスタート

このセクションでは、espresso-mcpのインストール、使用方法、利用可能なツール、ローカルセットアップ、デバッグ、リントとテスト、公開方法について説明します。

📦 インストール

• Python 3.x
• uv: pip install uv

# 標準入出力モードで実行
uvx espresso-mcp

# SSEモードで実行
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"]
    }
  }
}

📚 ドキュメント

利用可能なツール

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デバイスの特定の座標でタップをシミュレートします。
• swipe：接続されたAndroidデバイスで特定の方向にスワイプジェスチャーを実行します。

利用可能なリソース

以下のリソースが利用可能です。

• config://app：静的な設定データを取得します。
• greeting://{name}：パーソナライズされた挨拶を取得します。

🔧 技術詳細

ローカルセットアップ

• Python 3.x
• uv: pip install uv

# 依存関係のインストール
uv sync
# または
uv sync --frozen --all-extras --dev

# サーバーの実行
uv run espresso-mcp

# 開発モードで実行
uv run mcp dev src/espresso_mcp/server.py

デバッグ

• MCPインスペクターを使用します。

# MCPインスペクターのインストール
yarn global add @modelcontextprotocol/inspector

# MCPサーバーのテスト
yarn run @modelcontextprotocol/inspector python server.py

リントとテスト

# リント
uv run ruff check

# テスト
uv run pytest

公開

# パッケージのビルド
uv build
uv build --wheel
uv build --no-sources

# PyPIへのアップロード
uv publish

開発ノート

uv tool install espresso-mcp

# または

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