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

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": [
        "termux",
        "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 install 相关包
4. 填写env相关信息（前提是termux开启sshd，termux-api-tools-mcp-server.py可以通过网络请求的到termux）

测试截图

已知问题

• 获取设备上所有无线电模块 (termux-telephony-cellinfo) 有点问题
• cherry stduio调用电话cell功能存在异常
• 其他偶发的调用失败情况（可能是手机兼容性问题）
• 还有几个不常用的API未通过本地测试故没有添加进项目

免责声明

本项目为学习练习用途，开发者对使用本项目可能造成的任何后果不承担责任。涉及敏感操作的功能请谨慎使用，并遵守当地法律法规。

未来计划

• 完善代码异常处理
• 增加更多设备控制功能如需更多Android信息可以参考ADB-MCP-Server
• 提高代码质量和安全性

新人练手项目，请多包涵！联系作者：B站@忘月沁