通过MCP、CLI或技能，控制Android手机的编码代理。无需API密钥。
概览
给你的编码代理一个安卓手机。 你现有的编码代理决定执行什么;电话使用则提供一个小型MCP服务器和JSON CLI通过Android调试桥（ADB）观察和操作设备。代理本身可能有自己的订阅或型号需求。电话使用则不增加任何要求。 Android 优先，MIT 授权，Python 3.11+。无配套 APK、root 或遥测。iOS 和 Unicode 文本输入在 v0.1 中不支持 。可选的托管中继通过 Cloudflare 转发电话数据;详见其隐私声明。 观看真实的Android演示（28秒）：一个带截图的MCP客户端输入示例文本，按下应用，并通过生产HTTPS中继检查结果。连续的手机捕获以2倍速显示;这是一个技术演示，不是ChatGPT开发者模式的录制。 安装安卓平台工具，启用USB调试，连接解锁手机，并接受其调试授权。如果不想使用个人设备，使用模拟器。
概述（AI 翻译）
给你的编码代理一个安卓手机。
**没有API密钥。没有嵌入式LLM。没有云端账户。**你现有的编码代理会决定 该做什么;phone-use 提供了一个小型 MCP 服务器和 JSON CLI 用于观察和操作 设备通过 Android 调试桥（ADB）进行。代理本身可能拥有自己的订阅 或型号要求。手机使用则不增加任何要求。
Android 优先，MIT 授权，Python 3.11+。无配套 APK、root 或遥测。 iOS 和 Unicode 文本条目在 v0.1 中不支持 iOS 和 Unicode 条目。可选的托管中继 通过Cloudflare转发手机数据;查看其隐私声明。
观看真实的安卓演示（28秒）： 一个截图引导的MCP客户端输入示例文本，点击应用，并检查结果 通过生产 HTTPS 中继。连续电话捕获显示为 2 倍速; 这是一个技术演示，不是ChatGPT开发者模式的录制。
快速开始
安装安卓平台工具， 启用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 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"phone-use": {
"command": "uv",
"args": ["run", "--locked", "--directory", "/absolute/path/to/phone-use", "phone-use", "serve"]
}
}
}