
Jav — 非根的 Android 控制运行时,基于 MCP:设备内 UI 自动化、原生遥测 API 和双层 AI(Jev + director)
概览
规范细节存在于 AGENTS.md、PROTOCOL.md、ARCHITECTURE.md、PLAN.md 以及文档/规范中。 设备内应用(dev.k4wai1.jav)通过AccessibilityService显示屏幕,并通过用户启动的特权操作向PC上的Go MCP服务器(jav, cmd/jav, stdio)执行。 Jav从不循环,从不计划,也不发明坐标。导演握着环;Jav握着装置。 每个工具返回{ok, verified, evidence, hint}。验证:仅在真实后验证时为真,绝不在“命令发送”时。工具/列表每个工具包含紧凑的1–2行描述;完整的7部分规范作为MCP资源加载(android://tool/,android://tools/,索引 android://tools/catalog)。启动时使用真实的tiktoken分词器测量:(指令+38个简洁描述)和(包含38个工具的固定MCP模式,未合并不可简化)——即v1.2.0之前~8.8k。参见文档/基准测试/PERFORMANCE.md §9。
概述(AI 翻译)
全控制的Android MCP运行时。无root权限。
以无障碍为先的设备应用 + Go MCP 服务器(标准):38 个原子工具, 雫门壳,配有 WS/尾网,配有 TOFU 钉针。
发行作品 · 协议· 基准测试 · 计划
英语优先,西班牙语 después。 规范细节存在于
AGENTS.md,PROTOCOL.md、ARCHITECTURE.md、PLAN.md和docs/specs/。
什么是贾夫
Jav 是一个完全控制的 Android MCP 运行时,无需 root 权限。 一个设备内应用
(Jav, dev.k4wai1.jav)通过AccessibilityService曝光屏幕,且
通过Shizuku(由用户发起)对Go MCP服务器进行特权操作
PC(jav,标准)。
| Jav(本仓库) | Director(外部,非Jav的一部分) | |
|---|---|---|
| 什么 | Go MCP 服务器(cmd/jav)+ Android 应用 dev.k4wai1.jav |
OpenCode / Claude / 光标 / 操作符 |
| 是否 | 暴露38个原子MCP工具,不运行循环,也不运行内部规划器 | 读取每个屏幕,每步选择一个原子工具,验证效果 |
| 战术帮助 | 发球 resolve_element(盲目第一季Jev解决器) |
决定目标、开门并批准预览 |
Jav从不循环,从不计划,也不发明坐标。导演保持
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
English first, español después. Normative detail lives in
AGENTS.md,PROTOCOL.md,ARCHITECTURE.md,PLAN.mdanddocs/specs/.
What is Jav
Jav is a full-control Android MCP runtime without root. An on-device app
(Jav, dev.k4wai1.jav) exposes the screen via AccessibilityService and
privileged actions via Shizuku (started by the user) to a Go MCP server on
the PC (jav, stdio).
| Jav (this repo) | Director (external, not part of Jav) | |
|---|---|---|
| What | Go MCP server (cmd/jav) + Android app dev.k4wai1.jav |
OpenCode / Claude / Cursor / operator |
| Does | exposes 38 atomic MCP tools, runs no loops and no internal planner | reads each screen, picks one atomic tool per step, verifies the effect |
| Tactical help | serves resolve_element (blind S1 Jev resolver) |
decides goals, gates, and approves previews |
Jav never loops, never plans and never invents coordinates. The Director holds the loop; Jav holds the device.
Architecture
Interactive version: docs/diagrams/jav-architecture.html
How the flow works with Jev — recommended: OpenRouter
The Director reads the screen, picks one atomic tool per step and verifies the
effect. When the screen is noisy, resolve_element adds a blind tactical
resolver (S1 Jev): the accessibility tree is pruned to a numbered table
(≤254 candidates) and Jev answers in a single pass — a Choice + confidence,
no free text, anti-prompt-injection by construction. conf ≥ 0.70 (tau) or
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →