Termux Server

通过 MCP 协议让 Claude Desktop 远程控制 Android 手机。运行在 Termux 上，提供 45+ 工具，支持 UI 自动化操作。

功能

UI 自动化：控制任意 App

核心能力：通过截图 → 分析 → 点击的循环，可以操控手机上任意应用。

工作流程

take_screenshot → Claude 看到屏幕内容
      ↓
dump_ui        → 获取所有UI元素及坐标
      ↓
tap_screen     → 点击目标位置
input_text     → 输入文字
      ↓
take_screenshot → 确认操作结果，继续下一步

示例：用微信给某人发消息

Claude 会自动执行以下步骤：

1. open_app("com.tencent.mm") — 打开微信
2. take_screenshot() — 查看当前屏幕
3. dump_ui() — 获取UI元素坐标
4. find_and_tap("通讯录") — 点击通讯录
5. find_and_tap("搜索") — 点击搜索框
6. input_chinese_text("张三") — 输入联系人名字
7. find_and_tap("张三") — 点击搜索结果
8. find_and_tap("发消息") — 点击发消息
9. tap_screen(x, y) — 点击输入框
10. input_chinese_text("你好，明天几点见面？") — 输入消息
11. find_and_tap("发送") — 发送

你只需要对 Claude 说："打开微信给张三发消息说明天几点见面"，Claude 会自动完成以上全部步骤。

安装

1. 手机端 (Termux)

# 安装依赖
pkg install python termux-api

# 安装 Termux:API app (从 F-Droid)
# https://f-droid.org/packages/com.termux.api/

# 授予存储权限
termux-setup-storage

# 进入项目目录
cd ~/pypro/termux-mcp-server

# 创建虚拟环境并安装
python -m venv .venv
source .venv/bin/activate
pip install "mcp[cli]"

# 测试运行
python termux_mcp_server.py

2. 远程连接 (SSH)

手机端启动 SSH 服务供电脑连接：

pkg install openssh
sshd  # 默认端口 8022
whoami  # 记住用户名
passwd  # 设置密码
ifconfig  # 记住IP地址

3. 电脑端 Claude Desktop 配置

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "termux": {
      "command": "ssh",
      "args": [
        "-p", "8022",
        "[email protected]",
        "/data/data/com.termux/files/home/pypro/termux-mcp-server/.venv/bin/python",
        "/data/data/com.termux/files/home/pypro/termux-mcp-server/termux_mcp_server.py"
      ]
    }
  }
}

将 u0_a123 替换为 whoami 输出，192.168.1.100 替换为手机IP。

免密登录（推荐）：

# 电脑端
ssh-keygen -t ed25519
ssh-copy-id -p 8022 [email protected]

使用示例

连接成功后，可以在 Claude Desktop 中直接说：

基础操作：

• "查看手机电量"
• "手机现在连着什么WiFi"
• "拍一张照片"
• "打开手电筒"
• "手机在哪里"（GPS定位）

App 控制（UI 自动化）：

• "打开微信给张三发消息说明天见"
• "帮我打开抖音"
• "截个屏让我看看手机画面"
• "点击屏幕上的xxx按钮"
• "在当前输入框输入xxx"

通信：

• "给 13800138000 发短信说我到了"
• "查看最近的短信"
• "查看通讯录"

系统控制：

• "把手机音量调到5"
• "用手机说一句你好"
• "手机震动一下"

测试

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | python termux_mcp_server.py