---
title: "Phonegang"
description: "USBを介したアクセシビリティツリーによるAndroid端末の自動化。CLI、Python API、Claude Code向けMCPサーバー。"
canonical_url: "https://2389.ai/ja/research/products/phonegang/"
last_updated: "2026-08-06T15:35:08-05:00"
doc_version: "1.0"
date: 2025-10-13
product_type: "Tool"
tags: ["android", "automation", "accessibility", "mcp", "cli", "usb", "adb", "agents", "open-source"]
---

# Phonegang

> USBを介したアクセシビリティツリーによるAndroid端末の自動化。CLI、Python API、Claude Code向けMCPサーバー。


Phonegang はUSBを介してAndroid端末をアクセシビリティツリーで操作します。スクリーンリーダーが使う構造化データと同じものです。ピクセルのマッチングや座標のハードコーディングではなく、テキスト、リソースID、コンテンツ説明で要素を見つけます。CLI、Pythonライブラリ、Claude Code から直接スマートフォンを操作できるMCPサーバーとして提供されます。

## インストール

```bash
git clone https://github.com/2389-research/phonegang.git
cd phonegang
uv sync
```

Python 3.10+、USBデバッグが有効なAndroid端末、PATHにADBが必要です。

## できること

**CLIコマンド**で一般的な操作をカバーします: `phonegang tap-text "Login"`、`phonegang type "hello"`、`phonegang screenshot`、`phonegang scroll-to "Settings"`。生のUIツリーのダンプ、接続デバイスの一覧表示、アプリ管理、back/homeナビゲーションも可能です。

**Python API** で `DeviceManager`、`ADBDevice`、`DeviceController` を使えます。デバイスに接続し、アクセシビリティツリーをリフレッシュし、テキスト/クラス/リソースID/カスタム述語で要素を検索し、タップ、入力、スクロール、または要素の出現を待機します。ツリーオブジェクトはチェーンクエリをサポートします — すべてのボタンを検索し、サイズでフィルタリングし、クリック可能なものを取得。

**MCPサーバー**で高レベルツール (`get_screen`、`tap`、`type_text`、`wait_for`) と低レベルツール (`tap_xy`、`swipe`、`press_key`、`get_ui_dump`) をMCP経由で公開します。Claude Codeの設定に追加すれば、自然言語でスマートフォンを操作できます。

## 仕組み

下から上へ4つのレイヤー:

1. **ADBレイヤー** — `adb-shell` をラップして生のデバイス通信 (シェルコマンド、ファイルプッシュ/プル、入力イベント) を処理
2. **アクセシビリティツリーパーサー** — `uiautomator` XMLダンプを、バウンド、テキスト、リソースID、クリック状態を持つクエリ可能なPythonオブジェクトに変換
3. **デバイスコントローラー** — ADBと解析済みツリーを組み合わせて高レベル操作を実現 (find-and-tap、scroll-to-text、wait-for-element)
4. **CLI / MCP** — コントローラーを人間とAIエージェントに公開するClickベースのCLIとMCPサーバー

## 必要要件

- Python 3.10+
- USBデバッグが有効なAndroid端末
- ADB (Android Debug Bridge) — Android SDKに付属またはスタンドアロンでインストール
- `adb-shell`、`click`、`lxml` (`uv sync` で自動インストール)


## Sitemap

Parent: [プロダクト](https://2389.ai/ja/research/products/index.md)

Related pages in this section:

- [スキルマーケットプレイス](https://2389.ai/ja/research/products/skills-marketplace/index.md)
- [Mammoth](https://2389.ai/ja/research/products/mammoth/index.md)
- [BotBoard](https://2389.ai/ja/research/products/botboard/index.md)
- [Smasher](https://2389.ai/ja/research/products/smasher/index.md)
- [Jeff](https://2389.ai/ja/research/products/jeff/index.md)
- [Mux](https://2389.ai/ja/research/products/mux/index.md)
- [ISH](https://2389.ai/ja/research/products/ish/index.md)
- [Coven](https://2389.ai/ja/research/products/coven/index.md)
- [Soloclaw](https://2389.ai/ja/research/products/soloclaw/index.md)
- [ccvault](https://2389.ai/ja/research/products/ccvault/index.md)


Site index: [llms.txt](https://2389.ai/llms.txt) · [sitemap.md](https://2389.ai/sitemap.md) · [HTML](https://2389.ai/ja/research/products/phonegang/)