关于AI调用Termux这件事

SoloSu

最近也是闲着无聊，MT论坛APP的后续更新交给其他坛友了

在AI在实际使用中到处连接MCP，各种各样的工具，有点麻烦，就想着用Ai连接Termux，我只有两种方案，第一种是ssh连接，第二种是MCP连接

经过我和AI的慎重考虑，我选择了第二种，因为他是真的很简单！

以下是部署步骤，需要安装Python，需要安装Python！！！

附件需要将txt改为zip



Termux MCP 安装教程

适用于 Termux 上搭建 MCP (Model Context Protocol) 本地服务,让 AI 工具通过 SSE 协议连接并执行 Shell 指令。
零外部依赖,仅 Python 标准库,专为移动端优化。

---

目录

• 环境要求
• 安装步骤
• 启动服务
• AI 工具连接配置
• 管理命令
• 卸载方法
• 常见问题

---

1. 环境要求

项目	要求
设备	Android 7+
Termux	最新版 (F-Droid 渠道)
Python	3.8+(Termux 默认已安装)
存储权限	Termux 需获取文件访问权限

1.1 检查 Python 版本

1. python3 --version

复制代码

输出示例:Python 3.13.13
1.2 授予 Termux 存储权限(如需要访问 /sdcard/)

1. termux-setup-storage

复制代码

2. 安装步骤
2.1 准备安装包
将 termux-mcp.zip 放置到手机 /sdcard/ 目录下。
2.2 解压安装
方式 A:安装到 Termux 根目录(推荐,适用于其他设备)

1. cd ~
   
2. unzip /sdcard/termux-mcp.zip -d ~/termux-mcp
   
3. chmod +x ~/termux-mcp/*.sh ~/termux-mcp/*.py
   
4. cd ~/termux-mcp

复制代码

方式 B:安装到临时工作目录(仅测试用)

1. mkdir -p ~/.termux-mcp-tmp
   
2. cd ~/.termux-mcp-tmp
   
3. unzip /sdcard/termux-mcp.zip
   
4. chmod +x start.sh mcp_server.py

复制代码

2.3 验证文件
解压后应包含以下 3 个文件:

1. termux-mcp/
   
2. ├── mcp_server.py    # MCP 服务器(零外部依赖,约 15KB)
   
3. ├── start.sh         # 启动/停止/状态管理脚本
   
4. └── README.md        # 说明文档

复制代码

2.4 配置环境变量(可选)

变量	默认值	说明
TERMUX_MCP_PORT	3101	服务端口
TERMUX_MCP_HOST	0.0.0.0	监听地址(0.0.0.0 表示允许局域网连接)

3. 启动服务
3.1 启动

1. cd ~/termux-mcp
   
2. ./start.sh

复制代码

或指定端口:

1. TERMUX_MCP_PORT=3101 ./start.sh

复制代码

成功输出示例:

1. [INFO]  启动成功 (PID: 12345, 端口: 3101)
   
2. [INFO]  SSE: http://127.0.0.1:3101/sse

复制代码

3.2 查看运行状态

1. ./start.sh status

复制代码

3.3 健康检查

1. curl http://127.0.0.1:3101/health

复制代码

返回示例:

1. {
   
2.   "status": "ok",
   
3.   "uptime": "0:01:23",
   
4.   "commands_executed": 0,
   
5.   "errors": 0,
   
6.   "connections": 0,
   
7.   "version": "1.2.0"
   
8. }

复制代码

3.4 查看日志

1. ./start.sh log        # 实时查看
   
2. tail -f termux-mcp.log  # 或直接查看日志文件

复制代码

4. AI 工具连接配置
在 AI 工具(Cursor、Claude Desktop、Windsurf 等)的 MCP 配置中添加 SSE 端点:

1. {
   
2.   "mcpServers": {
   
3.     "termux-mcp": {
   
4.       "url": "http://<设备IP>:3101/sse"
   
5.     }
   
6.   }
   
7. }

复制代码

将 &lt;设备IP&gt; 替换为 Termux 设备在同一局域网下的 IP 地址。
查看本机 IP:

1. ip addr show wlan0 | grep inet | awk '{print $2}' | cut -d/ -f1
   
2. # 或
   
3. ifconfig wlan0 | grep inet

复制代码

5. 管理命令

命令	说明
./start.sh	启动服务(默认)
./start.sh start	启动服务
./start.sh stop	停止服务
./start.sh restart	重启服务
./start.sh status	查看运行状态
./start.sh log	实时查看日志
./start.sh help	查看帮助

6. 卸载方法

1. # 停止服务
   
2. cd ~/termux-mcp && ./start.sh stop
   
3. # 删除安装目录
   
4. rm -rf ~/termux-mcp
   
5. # 如曾使用临时目录
   
6. rm -rf ~/.termux-mcp-tmp

复制代码

7. 常见问题
Q: 端口被占用怎么办?

1. # 使用其他端口启动
   
2. TERMUX_MCP_PORT=3102 ./start.sh

复制代码

Q: 如何开机自启动?
在 Termux:Boot 中添加:

1. #!/data/data/com.termux/files/usr/bin/bash
   
2. cd ~/termux-mcp
   
3. ./start.sh start

复制代码

Q: 外网设备无法连接?
确保:

• 手机和 AI 工具在同一局域网
• Termux 有后台运行权限(在系统设置中关闭电池优化)
• 防火墙未阻止 3101 端口

Q: 如何更新服务?

1. cd ~/termux-mcp
   
2. ./start.sh stop
   
3. # 备份配置文件(如有)
   
4. # 重新解压覆盖
   
5. unzip -o /sdcard/termux-mcp.zip -d ~/termux-mcp
   
6. ./start.sh start

复制代码

---

技术特性: 零外部依赖、线程池(最大20线程)、输出截断512KB、5分钟无活动自动断开、优雅关闭、日志轮转(2MB/保留2个备份)。

空雨pro

感谢分享

CodeForge

有了 CodeForge，Termux 就不需要了。

GoldApple1939

感谢分享

qq77132421

termux里面能直接安装codex啊

太阳686

看看

我是小白菜

看看怎么样

何宝瑞

感谢分享

橘子v

看看隐藏

zxasdc6594

没必要啊

SoloSu

zxasdc6594 发表于 2026-8-21 07:46
没必要啊

有的人需要，比如我即使用MCP也是用ssh

zxasdc6594

SoloSu 发表于 2026-8-21 07:59
有的人需要，比如我即使用MCP也是用ssh

termux有AI控制。。没必要搞这些

SoloSu

zxasdc6594 发表于 2026-8-21 19:02
termux有AI控制。。没必要搞这些

这个我不习惯，感觉不是很好用

huaderui

启用太麻烦了，能不能做过一键启动mcp

zxasdc6594

SoloSu 发表于 2026-8-21 19:30
这个我不习惯，感觉不是很好用

那就用atomcode。。全套