termux-api-tools-mcp-server

termux-api-tools-mcp-server

4
os_automation

This project is a practice project designed to remotely control Android devices through an MCP client using Termux-API. It supports sensitive operations like acquiring phone information and managing calls/SMS. Users should exercise caution due to its handling of sensitive operations.

Project Overview

This project is a rookie practice project based on the Termux-API, mainly used to control Android devices through an MCP client. It provides sensitive operations, such as obtaining phone information and performing phone/SMS-related operations.

Features

  • Obtain phone-related information (some features may involve sensitive data)
  • Retrieve call logs and SMS records (sensitive operations)
  • Make calls and send SMS (sensitive operations)
  • Remote control via MCP client

Usage

  1. Import the JSON into Cherry Studio or Claude MCP client
  2. Modify the termux-api-tools-mcp-server.py location to your local file location
  3. Install related packages via pip
  4. Configure the environment variables (ensure Termux SSHD is enabled and the server can access Termux through network requests)

Known Issues

  • Problems with retrieving all radio modules on the device (termux-telephony-cellinfo)
  • Anomalies in calling phone cell functionality via Cherry Studio
  • Other occasional call failures (possibly due to phone compatibility issues)
  • A few less commonly used APIs not locally tested, hence not included in the project

Disclaimer

This project is for learning purposes, and the developer is not responsible for any consequences arising from its use. Please use functions involving sensitive operations cautiously and comply with local laws and regulations.

Future Plans

  • Improve error handling in code
  • Add more device control functions If more Android information is required, refer to ADB-MCP-Server
  • Enhance code quality and security.