# Nano MCP Termux

> Nano MCP Termux is an open-source MCP server for developer tools. Single-file, zero-dependency MCP server for Termux on Android, Raspberry Pi and Linux. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Android, Linux, CLI
- **Repository:** https://github.com/lmeng486/nano-mcp-termux
- **MCP Registry name:** io.github.Lmeng486/nano-mcp-termux
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

This is a small Python server meant to run on constrained devices, including phones under Termux. It exposes four tools: device_status for battery, storage, architecture and memory, server_health for pid, uptime, counters and live children, resolve_path for Android path details, and path_adapter for environment profile and storage roots.

Most of the engineering goes into lifecycle behaviour. Version 1.1.0 fixed a bug where timed-out commands left orphaned grandchildren, by starting each command in its own process group and killing the whole tree. It also exits when its parent dies or stdin closes, and warns about Android 12+ Phantom Process Killer risk. The path adapter handles /sdcard and /storage/emulated/0 equivalents, noexec mounts and case-insensitive filesystems.

It speaks newline-delimited JSON-RPC over stdio and echoes the client's protocol version among 2024-11-05, 2025-06-18 and 2025-11-25. Install with uvx or pip, run the file directly, or use Docker. MIT licensed.

## Features

- **Device status:** Reports battery, storage, architecture and memory, marking unavailable fields.
- **Server health:** Shows uptime, children, memory use and Android kill risk.
- **Android path resolver:** Maps equivalent paths and flags noexec and quoting hazards.
- **Clean process teardown:** Kills whole process groups on timeout.
- **Self-terminating:** Exits when the client disappears.
- **Single file:** No dependencies beyond Python.

## Good for

- Let an assistant inspect a Termux phone's resources
- Check mount flags before running a script on Android
- Run a lightweight MCP sidecar on a Raspberry Pi
- Diagnose Android background process kills

## Install

### Claude Code (Terminal)

```sh
claude mcp add nano-mcp-termux -- uvx nano-mcp-termux
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nano-mcp-termux": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
```

## FAQ

### What does it depend on?

Nothing beyond Python; it is a single file.

### How do I install it?

With uvx or pip, by running the file directly, or with Docker.

### What licence?

MIT.

### Is Nano MCP Termux free?

Yes. Nano MCP Termux is open source, so you can use and self-host it for free.

### How do I add Nano MCP Termux to Claude Code?

Run this command in your terminal: claude mcp add nano-mcp-termux -- uvx nano-mcp-termux

### What are the best alternatives to Nano MCP Termux?

The closest alternatives to Nano MCP Termux are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/nano-mcp-termux
