mcpserver.so LogoMCPFly
Submit
Termux-API-Tools-MCP-Server logo

Termux-API-Tools-MCP-Server

by hyhAsma

Development/AutomationTermuxAndroidAPIAutomationRemote Control

This project is a beginner's practice project based on Termux-API, mainly used to control Android devices through the MCP client. It provides some sensitive operation functions, including obtaining mobile phone information and performing telephone/SMS related operations.

View on GitHub

Last updated: N/A

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

This is a server application designed to allow remote control of an Android device running Termux via an MCP (Modular Control Panel) client. It leverages the Termux-API to expose device functionalities.

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

  1. Import the provided JSON configuration into an MCP client like Cherry Studio or Claude. 2. Modify the path to termux-api-tools-mcp-server.py to your local file location. 3. Install the required Python packages using pip install. 4. Configure the environment variables (TERMUX_SSH_HOST, TERMUX_SSH_PORT, TERMUX_SSH_USER, TERMUX_SSH_PASSWORD) to connect to the Termux SSH server.

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

  • Obtain phone information (potentially sensitive)

  • Retrieve call logs and SMS records (sensitive)

  • Make phone calls and send SMS messages (sensitive)

  • Remote control via MCP client

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

  • Remote device management

  • Automated mobile testing

  • Home automation (e.g., sending SMS alerts)

  • Educational purposes (learning Termux-API and remote control)

FAQ from Termux-API-Tools-MCP-Server

What is Termux?

Termux is an Android terminal emulator and Linux environment app that works directly with no rooting or setup required.

What is an MCP client?

MCP (Modular Control Panel) clients like Cherry Studio and Claude are used to remotely control and manage devices or applications through a modular interface.

Are there any security concerns?

Yes, this project involves sensitive operations. Use caution and consider using local LLMs for handling sensitive information. Ensure your Termux SSH server is properly secured.

What are the known issues?

There are known issues with retrieving cell information, calling functions in Cherry Studio, and occasional call failures due to phone compatibility. Some less commonly used APIs haven't been fully tested.

Where can I get help or contribute?

You can contact the author via their Bilibili account: @忘月沁. The project is a learning exercise, so contributions and feedback are welcome.