Termux-API-Tools-MCP-Server 项目说明
2025.05.04
1
PythonAndroid 设备控制远程控制敏感操作开发效率其它
Termux-API-Tools-MCP-Server 是一个基于 Termux-API 的项目，主要用于通过 MCP 客户端远程控制 Android 设备。它提供了获取手机信息、通话记录、短信记录以及执行电话/短信相关操作的功能。由于涉及敏感操作，使用时需谨慎并遵守当地法律法规。
View on GitHub
Overview
基本能力
产品定位
Termux-API-Tools-MCP-Server 是一个用于通过 MCP 客户端远程控制 Android 设备的工具，特别适合开发者和技术爱好者进行设备控制和信息获取。
核心功能
- 获取手机相关信息（部分功能可能涉及敏感数据）
- 获取通话记录、获取短信记录等功能（敏感操作）
- 拨打电话、发送短信等功能（敏感操作）
- 通过 MCP 客户端进行远程控制
适用场景
- 远程控制 Android 设备
- 获取设备信息进行调试或监控
- 自动化测试和开发
工具列表
termux-api-tools-mcp-server.py: 主服务脚本，用于连接 Termux 并执行相关操作。
常见问题解答
- 获取设备上所有无线电模块 (
termux-telephony-cellinfo) 有点问题 - cherry stduio调用电话
cell功能存在异常 - 其他偶发的调用失败情况（可能是手机兼容性问题）
- 还有几个不常用的API未通过本地测试故没有添加进项目
使用教程
使用依赖
- 确保 Termux 已安装并配置好 SSHD。
- 确保 MCP 客户端（如 cherry studio 或 claude）已安装。
安装教程
- 将提供的 JSON 配置导入 MCP 客户端。
- 修改
termux-api-tools-mcp-server.py的路径为本地文件位置。 - 安装相关 Python 包：
bash pip install 相关包 - 填写环境变量信息（确保 Termux 的 SSHD 已开启且可访问）。
调试方式
- 确保 Termux 的 SSHD 服务正常运行。
- 检查 MCP 客户端的连接配置是否正确。
- 运行
termux-api-tools-mcp-server.py并查看日志输出。bash python termux-api-tools-mcp-server.py