MCPBox — AI skill for Claude Code

MCP 文件盒 · MCPBox

**中文** | [English](README.en.md)

[](https://www.gnu.org/licenses/gpl-3.0) [](https://github.com/xtt-xt/MCPBox/actions/workflows/build.yml)

把 Android 手机变成一台 **MCP 文件服务器**：AI 客户端（RikkaHub / Claude Desktop / Cursor / Cline…）通过 MCP 协议读写手机文件、执行命令，而**每一次敏感操作都要经过手机上的悬浮窗审批**。

• 单 APK，无外部依赖：HTTP/MCP 服务器、自带浏览器控制台、常驻终端全部在这一个进程里
• 三档 shell 身份：应用沙箱 / Root / Shizuku（ADB shell）
• 权限不是"一次性全允许"，而是 8 个开关 × 三态 + 路径/命令级规则，审批弹窗浮在所有 App 之上

AI 客户端 ──HTTP(MCP)──▶ 手机上的 MCPBox ──▶ 文件系统 / shell
                              │
                              └─▶ 悬浮窗审批（允许一次 / 始终允许 / 拒绝 / 始终拒绝）

特性

52 个 MCP 工具	文件读写删、搜索、图片预览、回收站、设备信息、执行命令、自定义工具、令牌、记忆库、工具包、UI 自动化…
工具包	工具分 7 个包，默认只带 22 个（≈4100 token，比全量省 52%）；包由你在 App 里配置，AI 无感
会话隔离	客户端地址填 /mcp/p/<名字> 就是独立会话，各有各的激活状态，可持久化 / 重置 / 删除
预设会话	权限页一键切换「全部允许 / 全部拒绝 / 全部询问 / 自定义」；切走时自动记住你的自定义设置，切回来原样恢复
逐次审批	顶层悬浮窗 + 通知栏兜底，支持「允许一次 / 始终允许 / 拒绝 / 始终拒绝」
审批不限时	审批和命令超时都可以关掉（不限时）：弹窗不会自动消失、命令一直跑到自己结束
权限矩阵	8 个权限键三态（允许 / 询问 / 拒绝）+ 路径规则、命令规则（前缀 / 完全 / 正则）
工具级权限四态	单个工具可单独设「跟随 / 允许 / 询问 / 拒绝」，其中「询问」无视全局矩阵、每次都弹窗
记忆库	给 AI 的长期记忆：实体 + 观察 + 关系（知识图谱），能在 App 里浏览和编辑
文件网关	POST /upload、GET /download，外加手机浏览器直接可用的上传网页
应用私有目录	可读可写 /data/data/<包名>，三档（禁止 / 只读 / 可读写），经 root 转发
UI 自动化	截屏 + 读界面结构（控件树/坐标）+ 点击 / 滑动 / 输入（含中文）/ 按键 / 启应用 / 等元素，需要 Shizuku 或 Root
内置终端	常驻 shell，cd/export 状态保留、命令历史、Ctrl-C 中断、清屏
自定义工具	用命令模板给自己造新 MCP 工具，支持参数占位与 JSON 导入导出
网页控制台	浏览器里试工具、看日志、处理审批；支持仅本机访问与密码保护
两种传输	Streamable HTTP（/mcp）与旧版 HTTP+SSE（/sse + /messages）
多语言界面	中文 / English 内置，另可导出模板翻译成任意语言再导入

快速开始

1. 安装 APK，打开 App → 首页点开服务（默认端口 8720）
2. 给文件访问权限、悬浮窗权限、通知权限（首页「环境检查」会逐项提示）
3. 在 AI 客户端里添加 MCP 服务器：