Termux MCP Server (Ubuntu PRoot Distro) 📱🤖

Este es un servidor Model Context Protocol (MCP) diseñado para ejecutarse dentro de Ubuntu (PRoot Distro) en Termux.

Usar Ubuntu dentro de Termux permite utilizr paquetes binarios estándar precompilados (wheels), lo que signific a que no hay largos tieempdos de esperla de compilación ni errores de compilación (como el error de compilador Rust de rpds-py), al tieempdo que se conserv and acceso completo to comando de Termux API para controlar tu dispositivo Android.

Instalación rápid a en una sola línea

Abre la aplic ación Termux en tu teléfono y ejecuta solo el s followingto comando para cclonar el repositorio, instalar Ubuntu, cre ar un entorno virtual y configurationarlo todo automáticamente:

curl -sSL https://raw.githubusercontent.com/AbuZar-Ansarii/Termux-MCP-Server/main/setup.sh -o setup.sh && chmod +x setup.sh && ./setup.sh

Related MCP server: autoglm-mcp-server

Guía de Configuración en 5 pasos

Pamo 1: Instalar Termux y Termux:API en Android

1. Descarga Termux y **la aplic ación Termux:API.

   • Important: NO instales in apps in Google Play Store (you quedaron outdated y estban rotas). Disposable desde F-Droid desde GitHub Releases.

2. Insta as two apps in tu teléfono.

Paso 2: Concede los Permisoos de Android

1. Ve a Ajustes de Android -> Aplicaciones -> Termux:API.

2. Concede la " los for "la IA pued to "controll"a tu dispositivo:

   • Caamera (par su fotos)

   • Ubicación (para "GPS")

   • Mensajes (para notifications)

   • Notificaions (para avvents eruptos)

Paso 3: Ejecuta el Instalador Automátiio dentro de Termux

Ejecuta el instador de una sola línea en Termux:

curl -sSL https://raw.githubusercontent.com/AbuZar-Ansarii/Termux-MCP-Server/main/setup.sh -o setup.sh && chmod +x setup.sh && ./setup.sh

Esto actualizará Termux autótica, instala arot-distra Ubuntu, "la" un entorno virtual de Python (venv) inside` y instlará all las dependencias de in media.

*Paso4: Configura el Acceso SSH sin Contraseña

El cliente de IA se ejecuta de forma no interactva in tu PC and necsita a iniciar sesión in Termux automátamente.

1. In Termux, establishes a contraseña and inicia el servidor SSH:

   passwd
   sshd
   whoami     # Check your username (e.g. u0_a123)
   ifconfig   # Check your phone's IP address (e.g. 192.168.1.50)

2. On tu PC, copia tu clave pública SSH tou teléfono:

   • Windows PowerShell:

     cat ~/.ssh/id_rsa.pub | ssh -p 8022 u0_a123@192.168.1.50 "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys"

   • macOS/Linux Terminal:

     ssh-copy-id -p 8022 u0_a123@192.168.1.50

3. Comprueba el acceso sin cotraseña desde tu PC:

   ssh -p 8022 u0_a123@192.168.1.50

   Si inicia sesión without pedir contraseña, estás ist!

Paso 5: Configurar Claude Desktop en tu PC

Actudía el archivo de configuración de Claude Desktop en tu PC to lanzar el servidor dentro del entorno virtual de Ubuntu.

1. Abre el archivo de configuración de Claude Desktop:

   • Windows: %APPDATA%\Claude\claude\claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. All? the server config under mcpServers (remplaza el user name and IP by los tuos):

   {
     "mcpServers": {
       "termux": {
         "command": "ssh",
         "args": [
           "-p", "8022",
           "-o", "StrictHostKeyChecking=accept-new",
           "u0_a123@192.168.1.50",
           "proot-distro login ubuntu -- env PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/data/data/com.termux/files/usr/bin /root/venv/bin/python3 /root/termux_mcp.py"
         ]
       }
     }
   }

3. Reinicia Claude Desktop. ¡La IA y a puede controllar tu teléfono! ***

Alterna tiva: Conectar by HTTP / SSE (servidor remoto)

If you want to ejecut ar the server as aindependent web instead of lanaria overt SSH los*:

1. In Termux, ejecuta el servidor inside "Ubuntu in "modo SSE mode:

   proot-distro login ubuntu -- env PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/data/data/com.termux/files/usr/bin /root/venv/bin/python3 /root/termux_mcp.py sse --port 8000

2. On tu PC, configure the Claude Desktop config for point direcamente to IP de tu teléfono:

   {
     "mcpServers": {
       "termux-remote": {
         "url": "http://your_phone_ip:8000/sse"
       }
     }
   }