Termux MCP Server

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

功能

| 分类 | 工具 | 说明 | |------|------|------| | 📱 设备信息 | get_battery_status get_device_info get_storage_info | 电池、型号、存储 | | 📍 定位 | get_location | GPS/网络定位 | | 📶 网络 | get_wifi_info scan_wifi get_telephony_info | WiFi、蜂窝网络 | | 📦 应用 | list_android_packages open_app open_url get_current_app | 查看/启动应用 | | 🖥️ UI自动化 | take_screenshot dump_ui tap_screen swipe_screen find_and_tap | 核心：控制任意App | | ⌨️ 输入 | input_text input_chinese_text input_keyevent long_press | 打字、按键、长按 | | 🏠 导航 | go_home go_back open_recent_apps | Home/返回/最近 | | 📷 相机/图片 | take_photo get_camera_info list_photos read_photo | 拍照、浏览图片 | | 💬 通信 | list_sms send_sms list_contacts | 短信、通讯录 | | 📋 剪贴板 | get_clipboard set_clipboard | 读写剪贴板 | | 🔔 通知 | send_notification show_toast | 发送通知/Toast | | 🔊 系统控制 | set_volume get_volume toggle_torch vibrate | 音量、手电筒、震动 | | 🗣️ TTS | text_to_speech | 文字转语音 | | 🎵 媒体 | media_player | 播放/暂停/停止音频 | | 📁 文件 | list_directory read_file write_file | 文件读写 | | ⚡ 命令 | execute_command | 执行Shell命令 | | 🔆 屏幕 | get_screen_brightness set_screen_brightness get_screen_size | 屏幕亮度/分辨率 | | 📡 传感器 | get_sensor_list read_sensor | 读取传感器数据 | | 🔗 分享 | share_file download_file | 分享/下载文件 | | 🔐 生物识别 | get_fingerprint | 指纹认证 |

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",
        "u0_a123@192.168.1.100",
        "/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 u0_a123@192.168.1.100

使用示例

连接成功后，可以在 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