Termux-API-Tools-MCP-Server 项目说明

目录

• 项目概述
• 功能特性
• 工作逻辑
• 如何使用
• 测试截图
• 已知问题
• 免责声明
• 未来计划

项目概述

该项目是一个基于Termux API的新用户培训项目，主要用于通过MCP客户端控制Android设备。它提供了一些敏感操作功能，包括获取手机信息以及执行与电话/短信相关的操作。

注意：此项目涉及敏感功能，请谨慎使用。建议尽可能使用本地LLM处理敏感信息。

功能特性

• 获取与手机相关的信息（某些功能可能涉及敏感数据）
• 检索通话记录、短信记录和其他敏感操作
• 执行拨打电话和发送短信等功能（敏感操作）
• 通过MCP客户端进行远程控制

工作逻辑

该项目采用以下工作逻辑：

1. Android设备（Termux环境）和MCP客户端位于同一局域网内；
2. Termux启用SSHD并配置远程登录；
3. termux-api-tools-mcp-server.py可以连接到Termux；
4. 通过MCP客户端JSON配置建立连接：

{
    "termux-api-mcp-tools": {
      "name": "termux-api-mcp-tools",
      "type": "stdio",
      "isActive": true,
      "tags": [
        "term-ux",
        "android",
        "mobile"
      ],
      "command": "python.exe",
      "args": [
        "D:\\test\\termux-api-mcp\\termux-api-tools-mcp-server.py"
      ],
      "env": {
        "TERMUX_SSH_HOST": "192.168.x.xx",
        "TERMUX_SSH_PORT": "xxxx",
        "TERMUX_SSH_USER": "username",
        "TERMUX_SSH_PASSWORD": "password"
      }
    }
}

如何使用

1. 将上述JSON导入Cherry Studio或Claude等MCP客户端；
2. 修改其termux-api-tools-mcp-server.py的位置到本地文件位置；
3. 使用pip安装相关包；
4. 填写env中的相关信息（假设termux已启用sshd，并且可以通过网络从termux请求termux-api-tools-mcp-server.py）；

测试截图

<img src="https://github.com/hyhAsma/termux-api-tools-mcp-server/blob/main/showImgs/img1.png" width="510px"> <img src="https://github.com/hyhAsma/termux-api-tools-mcp-server/blob/main/showImgs/img2.png" width="510px"> <img src="https://github.com/hyhAsma/termux-api-tools-mcp-server/blob/main/showImgs/img3.jpg" width="510px">

已知问题

• 获取设备上所有无线模块（termux-telephony-cellinfo）存在问题
• Cherry STDUIO调用电话cell功能时出现异常
• 其他偶尔出现的调用失败（可能是由于与手机的兼容性问题）
• 还有一些不常用的API尚未通过本地测试，未添加到项目中

免责声明

本项目仅用于学习和练习目的，开发者不对使用本项目可能产生的任何后果负责。请谨慎使用涉及敏感操作的功能，并遵守当地法律法规。

未来计划

• 改善代码异常处理
• 增加更多设备控制功能对于更多的Android信息，请参考ADB MCP Server
• 提升代码质量和安全性

新手培训项目，请原谅我！联系作者：Bilibili@Forget Moon Qin