Android SSH MCP 服务器
通过SSH从AI助手控制你的Android设备
  
高性能 MCP（Multiple Correspondence Plateau，多重对应高原） 用Rust编写的服务器，通过Termux为Android设备提供安全的SSH访问。
*示例：在Android上，AI助手列出文件并浏览目录*
______________________________________________________________________
为何使用这个？
将你的Android设备变成一台可编程的计算机，与AI实现自然交互。无需每次检查或运行命令时都手动通过SSH连接到手机，只需询问Claude即可：
- “检查我的Termux后台服务是否正在运行”
- “将这篇论文下载到我的平板电脑上”
- “查找我设备上所有大于10MB的PDF文件”
特点/功能
- 交互式设置工具 - 通过与Claude的自然对话进行配置
- 轻便且快速 - 401千字节的二进制文件，内存安全的Rust实现
- 智能安全 - 81个已白名单的只读命令可自由运行，写操作需要明确的工具
- 防弹级连接 - 自动重连并带有重试逻辑，处理网络中断
- 灵活认证 - SSH密钥或密码认证
- 隐私优先 - 仅本地连接，数据不会离开您的网络
快速入门
# Install
cargo install mcp-android-ssh
claude mcp add --scope user --transport stdio mcp-android-ssh mcp-android-ssh
# Setup Termux (on Android)
pkg install openssh && sshd
# Copy your SSH key
ssh-copy-id -p 8022 -i ~/.ssh/id_ed25519.pub u0_a555@192.168.1.100
# Configure via Claude (recommended) - just ask:
"Set up Android at 192.168.1.100, user u0_a555, key ~/.ssh/id_ed25519"
# Then restart from /mcp menu
# Or manually edit: ~/.config/mcp-android-ssh/config.tomlDetailed Setup Guide (click to expand)
详细设置
安装与配置
步骤1：安装并添加到Claude代码中
cargo install mcp-android-ssh
claude mcp add --scope user --transport stdio mcp-android-ssh mcp-android-ssh步骤2：设置您的Android设备
在您的Android设备上的Termux中：
# Install and start SSH server
pkg update && pkg install openssh && sshd
# Find your username and IP address
whoami # Example: u0_a555
ifconfig wlan0 # Example: 192.168.1.100步骤3：设置SSH密钥认证（推荐）
在您的主机上：
# Generate SSH key (skip if you already have one)
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ""
# Copy key to Android (replace with your username and IP)
ssh-copy-id -p 8022 -i ~/.ssh/id_ed25519.pub u0_a555@192.168.1.100步骤4：配置服务器
选项A：让克劳德进行配置（最简单）
只需让克劳德来设置一下：
"Set up my Android connection at 192.168.1.100, user u0_a555, use ~/.ssh/id_ed25519"然后从（相应位置/系统）重启MCP服务器 /mcp Claude 代码中的菜单。
选项B：手动配置
编辑 ~/.config/mcp-android-ssh/config.toml：
host = "192.168.1.100" # Your Android device IP
port = 8022 # SSH port (default 8022 for Termux)
user = "u0_a555" # Your Termux username
key_path = "~/.ssh/id_ed25519" # Path to your SSH private key
# Optional: password authentication (not recommended)
# password = "your_password"选项C：使用环境变量
通过环境变量进行配置（对测试很有用）：
export ANDROID_SSH_HOST=192.168.1.100
export ANDROID_SSH_USER=u0_a555
export ANDROID_SSH_KEY_PATH=~/.ssh/id_ed25519就这样！开始让你的AI助手与你的安卓设备进行互动吧。
______________________________________________________________________
使用示例
文件管理
- “显示我从/sdcard/DCIM目录中的最新照片”
- “查找所有大于10MB的PDF文件”
- “我手机上占空间最大的是什么？”
开发与监控
- “检查我的 PostgreSQL 服务器是否正在运行”
- “显示按内存排序的运行进程”
- “给我显示服务器日志的最后50行”
系统管理
- “在我的设备上安装python和pip”
- “为我的Termux主目录创建备份”
- “将此数据集下载到/sdcard”
数据分析
- “在我的照片中查找重复文件”
- “使用 dumpsys 分析我的应用使用情况”
______________________________________________________________________
API 参考文档
服务器提供了三款MCP工具供Claude使用：
execute_read - 安全的只读命令
执行已白名单列出的只读命令，无需用户批准。非常适合浏览文件、检查系统状态和收集信息。
81条白名单命令包括：
- 文件操作：
ls，cat，head，tail，grep，find，tree - 系统监控：
ps，top，df，du，free，uptime - 网络：
ping，netstat，ss，ifconfig - 文本处理：
wc，sort，cut，jq - 在源代码中查看完整列表
参数：
command(字符串，必填) - 要执行的shell命令timeout（数字，可选）- 超时时间（秒）（默认：30，最大：300）
示例： ls -lah /sdcard/Download
______________________________________________________________________
execute - 完全命令访问权限
执行任何命令，包括写入/修改/删除操作。使用此功能来安装软件包、创建文件或修改系统状态。
参数：
command(字符串，必需) - 要执行的shell命令timeout（数字，可选）- 超时时间（秒）（默认：30，最大：300）
示例： pkg install git
注： 未在（系统/列表中）白名单中的命令 execute_read 将会自动建议使用这个工具。
______________________________________________________________________
setup - 交互式配置助手
通过Claude直接配置您的Android SSH连接。支持部分更新，并在缺少信息时为您提供指导。
参数（全部可选）：
host(字符串) - Android 设备的 IP 地址port(数字) - SSH 端口（默认：8022）user(字符串) - Termux 用户名key_path(字符串) - SSH私钥的路径password(字符串) - SSH 密码（不推荐使用）
用法：
一次性完成全部设置：
"Set up Android at 192.168.1.100, user u0_a555, key ~/.ssh/id_ed25519"或者逐步地——克劳德会要求提供缺失的信息：
"Help me set up my Android connection"仅更新一个字段：
"Change the host to 192.168.1.101"设置完成后，从（相应位置）重启MCP服务器 /mcp 菜单。
______________________________________________________________________