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

Name: Termux-API-Tools-MCP-Server 项目说明
Author: hyhAsma

@hyhAsma

代码仓库

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

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

#termux #android #mobile

基本信息

分类

开发工具

许可证

MIT

运行时

python

传输方式

stdio

发布者

hyhAsma

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "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"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Termux-API-Tools-MCP-Server?

Termux-API-Tools-MCP-Server is a project that enables remote control of Android devices by running Termux-API commands through an MCP client. It provides sensitive operations including retrieving phone information, call logs, SMS records, and making calls or sending messages.

How to use Termux-API-Tools-MCP-Server?

Import the JSON configuration (shown in the README) into an MCP client (e.g., Cherry Studio, Claude). 2. Modify args to point to the local path of the termux-api-tools-mcp-server.py script. 3. Install required Python packages via pip install. 4. Fill in the env fields (SSH host, port, user, password) after ensuring Termux has SSHD enabled and the server can reach Termux over the network.

Key features of Termux-API-Tools-MCP-Server

Retrieve Android device information (may include sensitive data)
Fetch call logs and SMS records
Make phone calls and send SMS messages
Remote control via MCP client over local network
Operates through Termux API and SSH connection

Use cases of Termux-API-Tools-MCP-Server

Automate phone call or SMS workflows from a desktop MCP client
Remotely view call logs and SMS history on an Android device
Integrate Android device control into AI assistant or automation pipelines
Learn how to build an MCP server interacting with Termux-API

FAQ from Termux-API-Tools-MCP-Server

What are the prerequisites for using this server?

Android device must have Termux installed with SSHD enabled and be on the same local network as the MCP client. Python and required packages must be installed on the client machine.

How does it connect to the Android device?

The server uses SSH credentials (host, port, user, password) specified in the environment variables to connect to Termux and execute Termux-API commands.

What known issues exist?

Getting cell info from all radio modules (termux-telephony-cellinfo) has problems; Cherry Studio’s call cell function fails; occasional call failures due to phone compatibility; several infrequently used APIs are not included.

Is this project production-ready?

No. It is a learning/practice project with limited error handling and security. The developer disclaims any liability and advises using local LLMs for sensitive data.

Where is the source code located?

The Python script termux-api-tools-mcp-server.py is part of this repository. The JSON configuration must be adjusted to point to the correct local path.