📦

Termux API Tools MCP Server

基于Termux-API的部分指令，用于MCP客户端操控Android设备的服务端

0 installs

9 stars

2 forks

Trust: 49 — Fair

Devtools

Installation

npx termux-api-tools-mcp-server

Ask AI about Termux API Tools MCP Server

I know everything about Termux API Tools MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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

项目概述

本项目是一个基于 Termux-API 的新人练手项目，主要用于通过 MCP 客户端操控 Android 设备。它提供了部分敏感操作功能，包括获取手机信息和执行电话/短信相关操作。

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

功能特性

获取手机相关信息（部分功能可能涉及敏感数据）
获取通话记录、获取短信记录等功能（敏感操作）
拨打电话、发送短信等功能（敏感操作）
通过 MCP 客户端进行远程控制

工作逻辑

项目采用以下工作逻辑：

Android 设备（Termux 环境）与 MCP 客户端处于同一局域网；
Termux开启SSHD，并配置远程登陆；
termux-api-tools-mcp-server.py可以链接的到Termux；
通过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"
      }
    }
}

如何使用

将上述JSON导入cherry studio或claude等MCP客户端；
修改其termux-api-tools-mcp-server.py位置为自己本地文件位置
pip install 相关包
填写env相关信息（前提是termux开启sshd，termux-api-tools-mcp-server.py可以通过网络请求的到termux）

测试截图

已知问题

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

免责声明

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

未来计划

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

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