MCP.so
Sign In

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

@hyhAsma

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

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

Basic information

Category

Developer Tools

License

MIT

Runtime

python

Transports

stdio

Publisher

hyhAsma

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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?

  1. 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.

Comments

More Developer Tools MCP servers