MCP 文件盒 · MCPBox

把 Android 手机变成一台 MCP 服务器：AI 客户端通过 MCP 协议读写手机文件、执行命令、控制浏览器和界面。不需要电脑，也不需要 Termux。

每一次敏感操作都要在手机上点一次同意 —— 允许一次 / 始终允许 / 拒绝 / 始终拒绝。

AI 客户端 ──HTTP(MCP)──▶ 手机上的 MCPBox ──▶ 文件 / 终端 / 浏览器
                              └──▶ 审批（悬浮窗 / 通知栏）

下载

Releases 里下载 MCPBox-v1.4.0-151-release.apk（约 3.9 MB）。

启动服务：打开 App，首页点开服务，默认端口 8720
授权：首页「环境检查」会逐项提示。有 Root / Shizuku 时，文件访问、悬浮窗、忽略电池优化会在打开 App 时自动补上；通知权限要在系统弹窗里自己点一下
拿地址：首页「复制地址」，得到自带令牌的完整 URL
在客户端添加 MCP 服务器：

传输方式：Streamable HTTP（推荐）或 SSE
地址：    http://<手机局域网 IP>:8720/mcp
令牌：    已包含在上面的地址里

客户端只在连接时拉一次工具列表 —— 改完工具包要重连客户端或重启 App 才生效。

特性	一句话	细节
72 个 MCP 工具	文件、终端、界面、浏览器、记忆库、自定义工具、令牌	01
工具包	默认只给 AI 22 个工具，按需开包；也可以让 AI 自己开关	03
权限与审批	9 个权限键三态 + 路径 / 命令规则 + 单工具四态；审批可走悬浮窗或通知栏	02
内置终端	应用沙箱 / Root / Shizuku 三档身份，危险命令先弹窗	01
内置浏览器	AI 自己上网：读正文、点按、填表、滚页、执行 JS、截图、搜索；按页面管 cookie 与 UA，不需要 Root	06
界面控制	截屏 + 读控件树 + 点击 / 滑动 / 输入中文 / 启动应用（需 Root 或 Shizuku）	06
记忆库	给 AI 的长期记忆：实体 + 观察 + 关系，可在 App 里浏览、编辑、导入导出	04
文件通道与静态托管	`POST /upload` / `GET /download`、zip 整目录一次传、`/web` 直接预览手机里的网页	05
SSH / SFTP	内置服务端，客户端的「SSH 工作区」能直接读写手机文件；和 MCP 服务各有开关	11
备份 · 统计 · 多语言	记忆库 / 设置 / 自定义工具 / 统计 / 背景一键备份；请求热力图；中文 / English	07

任何支持 Streamable HTTP（MCP 2025-06-18）或 SSE 的客户端都能连，例如 RikkaHub、Claude Code、Cursor、Cline。只支持 stdio 的客户端（如桌面端 Claude）可以借助 mcp-remote 之类的桥接。

要填的就三样：地址 …/mcp、访问令牌、传输方式。

方案	需要什么	审批	局限
在 Termux 里自己跑 MCP 服务器	手动配 Python / Node 环境	没有，脚本拿到什么权限就是什么权限	每次重装都要折腾一遍，重启后要自己拉起来
电脑上跑服务器，手机文件同步过去	一台常开的电脑	在电脑上	手机离线就断，文件还要来回同步
MCPBox	一个 APK	每次敏感操作都要在手机上点	只有 Android；命令与界面控制仍需 Root / Shizuku

需要 Root 吗？
不需要。读写文件、记忆库、内置浏览器、静态托管开箱即用；执行命令和界面控制才要 Root 或 Shizuku。

会不会把文件传到别的地方？
不会。没有账号、没有开发者服务器、没有上报组件；数据都在应用私有目录，只有拿着访问令牌的客户端能调用工具。

锁屏或切到后台还跑吗？
前台服务 + 唤醒锁，锁屏照常工作。被系统省电策略回收后不会自己复活 —— 那本来就不是这个 App 的功能，建议把它加进电池优化白名单。App 被划掉后不保证继续运行。

局域网里的电脑连不上？
先看「设置 → 网络与访问 → 允许局域网访问」开着没有；再确认路由器没开 AP 隔离或把设备放进了访客网络；端口可以在同一页改（1024–65535）。

改了工具包，AI 还是看不到新工具？
客户端只在连接时拉一次工具列表，重连客户端或重启 App 就好。

忘了令牌怎么办？
首页「复制地址」随时能看；也可以在「权限 → 远程访问」里重置，旧令牌立刻失效，记得同步改客户端配置。

卸载会丢数据吗？
会。设置、记忆库、统计都在应用私有目录，卸载即删；要留就先去「设置 → 应用 → 备份与恢复」导出一份。

需要 JDK 17，仓库自带 Gradle wrapper：

./gradlew :harness:e2e          # 端到端测试
./gradlew :app:assembleRelease  # 正式包

签名、版本号与发版细节见 08 构建与发布。

详细文档在 docs/（中文）与 docs/en/（English）。

文档	内容
01 工具清单	72 个工具逐个说明：所属工具包、权限键、用途
02 权限与审批	权限矩阵、预设会话、单工具四态、路径 / 命令规则、超时、审批方式
03 工具包与会话	为什么要分包、各包内容与默认值、AI 自管开关、`/mcp/p/<名字>` 会话隔离
04 记忆库	实体 / 观察 / 关系、存储与界面、导入导出、合并与覆盖
05 文件通道与静态站点	上传下载、上传网页、zip 整目录、`/web` 静态托管、应用私有目录、网页控制台安全
06 浏览器与 UI 自动化	内置浏览器 18 个工具、按页面登录态、悬浮窗、已知限制；UI 自动化 8 个工具
07 统计 · 备份 · 引导	使用统计口径、备份与恢复、初始引导、开发者模式、多语言
08 构建与发布	三模块架构、目录结构、构建与测试、签名、GitHub Actions、发版流程
09 用户协议	使用约定、授权与确认、可接受的使用范围、风险与责任划分
10 隐私政策	数据存放位置、权限用途、网络访问、令牌与日志、备份文件
11 SSH 服务	内置 SSH / SFTP、认证与密钥、命令开关与身份、白名单与只读、真机踩坑

使用前请阅读用户协议与隐私政策（English / Privacy），App 内「关于」页也能随时查看全文。

一句话版本：文件、记忆、统计、令牌都只留在你自己的手机上；没有账号、没有开发者服务器、没有任何上报组件。