termux-api-tools-mcp-server

termux-api-tools-mcp-server

4
os_automation

This project is a practice project designed to remotely control Android devices through an MCP client using Termux-API. It supports sensitive operations like acquiring phone information and managing calls/SMS. Users should exercise caution due to its handling of sensitive operations.

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站@忘月沁