nano-mcp-termux
Zero-dependency, single-file MCP server for AI agents, natively running on Termux (Android), Raspberry Pi, and Linux.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
uvx nano-mcp-termux==1.1.1O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add io.github.lmeng486-nano-mcp-termux -- uvx nano-mcp-termux==1.1.1Execute em um terminal.
{ "mcpServers": { "io.github.lmeng486-nano-mcp-termux": { "command": "uvx", "args": [ "nano-mcp-termux==1.1.1" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Abrircd /path/to/nano-mcp-termux
python3 nano_mcp_termux.py
docker build -t nano-mcp-termux .
docker run -i --rm nano-mcp-termux
python3 nano_mcp_termux.py --health
This server does not run standalone — it's a sidecar that your AI client connects to via the MCP protocol.
Below are the three most common ways to mount it.
uvx), best for desktop AI clientsuvx nano-mcp-termux
Then add this JSON to your AI client's mcpServers config (see client‑specific notes below):
{
"mcpServers": {
"nano-mcp-termux": {
"command": "uvx",
"args": ["nano-mcp-termux"]
}
}
}
pip installed, or you prefer a direct Python launchpip install nano-mcp-termux
Config snippet for your AI client:
{
"mcpServers": {
"nano-mcp-termux": {
"command": "nano-mcp-termux"
}
}
}
# Clone or download the repo, then:
cd /path/to/nano-mcp-termux
python3 nano_mcp_termux.py
Config snippet for your AI client:
{
"mcpServers": {
"nano-mcp-termux": {
"command": "python3",
"args": ["/full/path/to/nano_mcp_termux.py"]
}
}
}
Tip: after editing the config file, restart your AI client so the new server is detected. If the client supports hot‑reload, you may not need a restart.
protocolVersion (2024-11-05 / 2025-06-18 / 2025-11-25), falls back to highest supporteddevice_status never fails; unavailable inputs are marked, not crashedSIGTERM → SIGKILL), never just the shell/sdcard ↔ /storage/emulated/0 ↔ $HOME/storage/shared, detects noexec mounts, case-insensitive filesystems, and shell-quoting hazardsVersion 1.0.0 ran commands with subprocess.run(..., timeout=...). On timeout,
Python terminates only the direct child — the sh -c wrapper. Anything the
shell had already spawned is reparented to init and survives forever. On
Android that is the exact leak class that trips the Phantom Process Killer
and can get the whole app group killed.
1.1.0 fixes this at the root: commands are spawned with start_new_session=True
and torn down with os.killpg(pgid, SIGTERM) → SIGKILL, so the entire process
tree dies together.
The repository ships a reproducible A/B regression test for it:
python3 test_lifecycle_orphan.py
# current nano_mcp_termux.py leaked_grandchildren=0
# legacy nano_mcp_termux_v10_backup.py leaked_grandchildren=1 <- the bug
# PASS: current server leaves 0 orphaned grandchildren after timeout
python3 test_client.py # 32 protocol / tool / lifecycle assertions
python3 test_lifecycle_orphan.py # orphan-leak A/B regression (1.0.0 vs 1.1.0)
This server is designed to pass Glama introspection checks and serve as a lightweight MCP implementation for mobile and edge devices.
Zero-dependency single-file MCP server for Termux/Android, Raspberry Pi and Linux
{ "mcpServers": { "io.github.lmeng486-nano-mcp-termux": { "command": "uvx", "args": [ "nano-mcp-termux==1.1.1" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Nano MCP Termux roda localmente via stdio.
Última verificação: 2026-11-09. Zero-dependency single-file MCP server for Termux/Android, Raspberry Pi and Linux