Termux MCP Server (Ubuntu PRoot Distro) 📱🤖

Dies ist ein Server für das Model Context Protocol (MCP), der dafür ausgelegt ist, innerhalb von Ubuntu (PRoot Distro) in Termux zu laufen.

Die Nutzung von Ubuntu innerhalb von Termux erlaubt es dir, standardmäßig vorkompilierte Binärpakete (wheels) zu verwenden. Das bedeutet keine langen Build-Wartezeiten und keine Kompilierfehler (wie den rpds-py-Rust-Compilerfehler), und du behältst weiterhin vollen Zugriff auf Termux-API-Befehle, um dein Android-Gerät zu steuern.

Schnellinstallation mit nur einem Befehl

Öffne die Termux-App auf deinem Telefon und führe diesen einen Befehl aus, um das Repo zu klonen, Ubuntu zu installieren, eine virtuelle Umgebung einzurichten und alles automatisch zu konfigurieren:

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

Einrichtungsanleitung in 5 Schritten

Schritt 1: Installiere Termux & Termux:API auf Android

1. Lade die Termux-App und die Termux:API-App herunter.

   • Wichtig: Installiere sie nicht aus dem Google Play Store (dort sind sie veraltet und defekt). Lade sie von F-Droid oder GitHub Releases herunter.

2. Installiere beide Apps auf deinem Telefon.

Schritt 2: Erteile Android-Berechtigungen

1. Gehe zu deinen Android-Einstellungen -> Apps -> Termux:API.

2. Erteile die folgenden Berechtigungen, damit die KI dein Gerät steuern kann:

   • Kamera (für Fotos)

   • Standort (für GPS-Koordinaten)

   • SMS (für Nachrichten)

   • Benachrichtigungen (für Pop-ups)

Schritt 3: Führe den Auto-Installer in Termux aus

Führe den Ein-Befehls-Installer in Termux aus:

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

Dieser aktualisiert Termux automatisch, installiert Ubuntu per proot-distro, richtet darin eine Python-Virtualumgebung (venv) ein und installiert alle Abhängigkeiten sofort.

Schritt 4: Konfiguriere passwortlosen SSH-Zugriff

Der KI-Client läuft nicht interaktiv auf deinem PC und muss sich automatisch bei Termux anmelden können.

1. In Termux: Lege ein Passwort fest und starte den SSH-Server:

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

2. Auf deinem PC: Kopiere deinen öffentlichen SSH-Schlüssel auf dein Telefon:

   • 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. Überprüfe den passwortlosen Zugriff von deinem PC:

   ssh -p 8022 u0_a123@192.168.1.50

   Wenn die Anmeldung ohne Passwortabfrage erfolgt, bist du bereit!

Schritt 5: Verbinde Claude Desktop auf deinem PC

Aktualisiere die Konfigurationsdatei von Claude Desktop auf deinem PC, um den Server in der virtuellen Ubuntu-Umgebung zu starten.

1. Öffne die Konfigurationsdatei von Claude Desktop:

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

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

2. Füge unter mcpServers die Server-Konfiguration hinzu (ersetze Benutzernamen und IP-Adresse durch deine):

   {
     "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. Starte Claude Desktop neu. Die KI kann jetzt dein Telefon steuern!

Alternative: Verbindung über HTTP / SSE (Remote-Server)

Falls du den Server als eigenständige Web-Anwendung ausführen möchtest, anstatt ihn per SSH stdio zu starten:

1. In Termux: Führe den Server in Ubuntu im SSE-Modus aus:

   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. Auf deinem PC: Konfiguriere deine Claude-Desktop-Konfiguration so, dass sie direkt auf die IP-Adresse deines Telefons zeigt:

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