sauravtom/phone-use
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP、CLI、またはスキルを介して、コーディングエージェントからAndroid携帯電話を制御する。 APIキーは必要ありません.
概要
Android携帯電話でコーディングエージェントの手を与えます。 既存のコーディングエージェントは何をするかを決定します。電話使用は、Android Debug Bridge(ADB)上のデバイスを観察および操作するための小さなMCPサーバーとJSON CLIを提供します。 エージェント自体は、独自のサブスクリプションまたはモデル要件を持つことができます。 電話使用はどれも追加します。 Android-first、MITライセンス、Python 3.11 +。 仲間のAPK、ルート、またはテレメトリーはありません。 iOS および Unicode テキストのエントリは v0.1 ではサポートされていません。 ホストされているリレーは、Cloudflareを通じて電話データを転送します。プライバシー通知を参照してください。 実際のAndroidデモ(28秒):スクリーンショットガイド付きMCPクライアントは、サンプルテキストをタイプし、適用を押し、生成HTTPSリレーを介して結果を確認します。 2x速度で示されている連続電話キャプチャ。これは、ChatGPT Developer Modeの録画ではなく、技術的なデモです。 Androidプラットフォームツールをインストールし、USBデバッグを有効にし、ロック解除された電話を接続し、デバッグ権限を受け入れます。 パーソナルデバイスを使用したくない場合はエミュレータを使用してください.
概要（AI 翻訳）
Android携帯電話でコーディングエージェントの手を与えます。
APIキーはありません。 埋め込まれたLM無し。 クラウドアカウントなし 既存のコーディングエージェントが決定 何をするか。電話使用は観察し、作動するために小さいMCPサーバーおよびJSON CLIを提供します Androidのデバッグブリッジ(ADB)上のデバイス。 エージェント自体は独自のサブスクリプションを持っている可能性があります またはモデル要件。 電話使用はどれも追加します。
Android-first、MITライセンス、Python 3.11 +。 仲間のAPK、ルート、またはテレメトリーはありません。 iOS および Unicode テキストのエントリは v0.1 ではサポートされていません。 オプションのホストされたリレー Cloudflareを通じて電話データを転送し、プライバシー通知を参照してください。
実際のAndroidデモ(28秒)を見る: スクリーンショットガイド付きMCPクライアントは、サンプルテキストをタイプし、適用を押し、結果をチェックします 生産の HTTPS のリレーを通して。 2xの速度で示される連続的な電話捕獲; これは、ChatGPT Developer Modeの録画ではなく、技術的なデモです。
クイックスタート
Androidプラットフォームツールをインストールします。 USB デバッグを有効にし、ロック解除された電話を接続し、デバッグ許可を受け入れます。 パーソナルデバイスを使用したくない場合はエミュレータを使用してください。
リポジトリをクローンし、uv でインストールします。
python -m pip install .], phone-use serve]].
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
phone-use
Give your coding agent hands on an Android phone.
No API keys. No embedded LLM. No cloud account. Your existing coding agent decides what to do; phone-use provides a small MCP server and JSON CLI to observe and operate the device over Android Debug Bridge (ADB). The agent itself may have its own subscription or model requirements. phone-use adds none.
Android-first, MIT licensed, Python 3.11+. No companion APK, root, or telemetry. iOS and Unicode text entry are not supported in v0.1. The optional hosted relay forwards phone data through Cloudflare; see its privacy notice.
Watch the real Android demo (28 seconds): a screenshot-guided MCP client types sample text, presses Apply, and checks the result through the production HTTPS relay. Continuous phone capture shown at 2x speed; this is a technical demo, not a recording of ChatGPT Developer Mode.
Quick start
Install Android platform-tools, enable USB debugging, connect an unlocked phone, and accept its debugging authorization. Use an emulator if you do not want to use a personal device.
Clone the repository, then install with uv:
git clone https://github.com/sauravtom/phone-use.git
cd phone-use
uv sync --locked
adb devices -l
uv run --locked phone-use call devices
uv run --locked phone-use call status
uv run --locked phone-use call observe
uv run --locked phone-use serve
Alternatively: python -m pip install ., then phone-use serve.
This repository is installable from source; no PyPI release is claimed.
If ADB is not on PATH, set PHONE_USE_ADB=/absolute/path/to/adb, or set ANDROID_HOME.
Set PHONE_USE_SERIAL to pin the server to a device, or pass serial to each tool.
Auto-selection works only when exactly one device is attached and authorized.
Hosted MCP
Use https://phone-use.xagi.in/mcp in an OAuth-capable MCP client. On the computer
connected to your Android device, run:
uv run --locked phone-use connect --serial YOUR_ADB_SERIAL
Start the MCP client’s connection flow, paste the one-time code from the bridge, and approve phone access. Pairing expires after 10 minutes; sessions last at most 8 hours. Stop the bridge to disconnect. This is an outbound connection: do not expose ADB to the internet. Each bridge is restricted to the explicitly selected device.
Codex plugin
Download the phone-use plugin ZIP for the bundled skill and CLI runtime. See plugin setup and submission status. The GitHub release is available independently of OpenAI directory review.
Add to your coding agent
Most MCP clients accept this stdio configuration (replace the path):
{
"mcpServers": {
"phone-use": {インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"phone-use": {
"command": "uv",
"args": ["run", "--locked", "--directory", "/absolute/path/to/phone-use", "phone-use", "serve"]
}
}
}