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.