Andro Jack MCP

AndroJack——所有安卓交易中的杰克

*一个MCP服务器，为你的AI编码助手提供实时、经过验证的Android知识，因此它是从官方来源构建的，而不是从记忆中构建的。*

](https://www.npmjs.com/package/androjack-mcp)  ](https://github.com/VIKAS9793/AndroJack-mcp/stargazers) ](https://github.com/VIKAS9793/AndroJack-mcp/graphs/traffic)    ](https://nodejs.org)   

    ](https://www.npmjs.com/package/androjack-mcp)

](https://androjack-web.netlify.app/) 

也适用于： Windsurf·VS代码复制品·谷歌反重力·JetBrains人工智能——见 手动设定 在......下面↓

VS代码分布： 也可以在VS Code Marketplace上作为 AndroJack MCP用于VS代码.

PM/APM文件： 产品战略、JTBD、人物角色、路线图、用户故事、竞争分析和GTM材料 产品管理/README.md.

______________________________________________________________________

目录

• 创建此工具的危机
• 什么在实践中真正打破
• 安德洛杰克做什么
• 诚实激活模型
• 什么仍然可以打破——即使在3级
• 纵深防御
• 杀手论
• 22工具
• 快速开始
• 手动设定
• 生态系统比较
• 安全与隐私
• 更新日志

______________________________________________________________________

🔥 创建此工具的危机

2025年 Stack Overflow开发者调查 向49000名开发人员询问了他们使用AI编码工具的经验。结果应该会让每个Android工程师感到震惊：

• 84%的开发者 现在使用人工智能编码工具——比前一年的76%有所上升。
• 对人工智能准确性的信任崩溃 从40%到刚刚 29% 在一年内。
• 2025年Stack Overflow访问量的35% 现在由开发人员调试和修复AI生成的代码触发。

使用和信任之间的差距并非巧合。它是结构性问题的产物： AI模型预测令牌，而不是API。 他们接受了关于世界快照的培训，没有机制知道API 30发生了什么变化，谷歌I/O 2025发布了什么，或者谷歌Play现在在审查时拒绝了什么。

对于Android开发人员来说，这种失败模式是非常危险的。Android拥有移动开发中发展最快的生态系统——每月都有一个新的Compose BOM，导航3在Nav2运行七年后趋于稳定，Android 16重写了屏幕方向锁定规则——大多数人工智能工具的训练数据在你使用它们时已经过时了六个月到两年。

结果不仅仅是糟糕的代码。它是 自信糟糕的代码。

______________________________________________________________________

⚡ 实践中真正突破的是什么——有据可查的证据

这些不是假设的风险。它们是真实开发人员项目中记录的故障模式。

The Navigation 3 Hallucination (January 2026)

已发表的案例研究来自 原子机器人 记录了实时导航2→ 导航3迁移使用Gemini和Claude，两者都启用了互联网接入。结论全文如下：

*“LLM仍然会产生幻觉。即使有互联网接入，两个代理都想使用过时的候选版本，而不是稳定的1.0.0版本。”*

导航3在同一个库运行了七年后，于2025年11月稳定下来。这是一次彻底的架构反思：后栈现在是简单的Kotlin列表，单片导航图已经不复存在 NavDisplay 替换 NavController谷歌自己的迁移指南非常清楚人工智能工具会出错，现在它包含了特殊的 “AI代理：”注释 --直接嵌入官方文档中的指令，供AI工具遵循。2026年，一个为新的Compose项目生成Nav2代码的AI工具犯了一个不小的错误。它正在造成一种架构不连贯，需要完全重写才能修复。

The Compose Deprecation Treadmill

Jetpack Compose每月都会发送一份新的物料清单。由于大多数模型的训练截止，这些API发生了变化：

每一个都编译。大多数运行时没有错误。这些错误稍后会出现在CI不稳定、UI退化或Play商店审查失败中。

The Android 16 / API 36 Mandate (August 2026 deadline)

Android 16进行了平台级更改，影响了每个发布的应用程序：在≥600dp的设备上——平板电脑、可折叠设备、ChromeOS——应用程序可以 不再锁定屏幕方向 或限制可调整性。Google Play要求在2026年8月之前将API 36定位为目标。

AI工具生成 android:screenOrientation="portrait" 或 android:resizeableActivity="false" 今天生成的代码将在Play Console中触发应用程序兼容性警告，无法通过大屏幕质量检查，并在Play商店搜索结果中降级应用程序。

商业影响不是理论上的： 可折叠用户在应用上的支出增加了14倍 仅使用手机的用户。平板电脑+手机用户花费9倍以上。FlipaClip在适应后的四个月内，平板电脑用户增长了54%。

The KMP Silent Failure

Kotlin多平台在2025年成为主流——发布了900多个新的KMP库，Room增加了对KMP的支持，公司现在专门为KMP技能而招聘。当KMP项目的开发人员要求AI工具添加数据库支持时，AI会生成仅限Android的Room代码。它编译。它在Android上运行良好。 iOS构建失败。 开发人员在意识到根本原因之前花了几个小时进行调试：他们的AI工具不知道KMP的存在。

______________________________________________________________________

🧩 安德洛杰克做什么

安德洛杰克是一个 基于文档的Android工程MCP服务器。它为您的AI编码助手 22种专用工具 它从官方的Android和Kotlin来源获取实时、经过验证的答案，而不是从过时的训练数据中进行预测。

这并没有让AI变得更聪明。它使AI 对证据负责。

将其视为LLM的预构建过梁。当其他工具检索文档时，AndroJack扮演着严格的架构看门人的角色。

Without AndroJack:  You ask → AI predicts from stale weights → Code (possibly wrong)

With AndroJack:     You ask → AI calls tool → Tool fetches official source live
                             → AI reads verified answer → Code (grounded)

______________________________________________________________________

⚠️ 诚信激活模型——两个层次

\[！重要\] 这是安装AndroJack之前要了解的最重要的事情。

第一级是被动的。 这些工具是可用的，但人工智能决定何时使用它们。构建Compose屏幕的AI可能会调用 architecture_reference 但跳过 material3_expressive --并悄无声息地违反M3E。

级别2处于活动状态。 这 androjack_grounding_gate 系统提示将每种任务类型映射到正确的工具。构建组合UI？AI被授权呼叫 material3_expressive 第一。添加依赖关系？它必须呼叫 gradle_dependency_checker。没有例外。

第三级是循环。 android_code_validator 在AI生成的每个代码块上运行，然后将其返回给用户。31条规则，涵盖删除的API、弃用的模式、Android 16和Android 17合规性。裁决 失败 这意味着AI必须修复并重新验证——用户永远看不到损坏的代码。

→ *要实现完全接地，请始终激活Level 2+Level 3。请参阅下面的“获得全额保证”。*

______________________________________________________________________

🪲 什么仍然可以打破——即使在3级

\[！重要\] AndroJack是一个文档开发和API验证工具。它不是Compose布局引擎、设计系统执行器或运行时渲染器。级别3捕获已删除的API和已弃用的模式。它无法捕获每一类Android漏洞。这不是AndroJack的限制，而是应用于可视化、运行时渲染的UI框架的静态文本分析的基本属性。

在使用AndroidJack构建的2级（v1.4.0）真实Android应用程序中遇到了以下错误。它们在这里被诚实地记录下来，所以你确切地知道要注意什么，以及在哪里可以找到不同的工具。

✅ 3级抓什么

// ❌ REMOVED — android_code_validator fires: REMOVED_ASYNCTASK
class MyTask : AsyncTask()

// ❌ REMOVED — fires: REMOVED_TEST_COROUTINE_DISPATCHER
val dispatcher = TestCoroutineDispatcher()

// ❌ DEPRECATED — fires: DEPRECATED_CONTEXTUAL_FLOW_ROW
ContextualFlowRow { Text("hello") }

// ❌ LEAK — fires: GLOBALSCOPE_LAUNCH
GlobalScope.launch { fetchData() }

⚠️ 什么级别3不能捕捉

\[！警告\] 在一个实际项目中发现了以下错误。它们是有效的APIcurrent Compose代码，违反了设计系统约束、可访问性最低要求或体系结构边界。静态文本扫描无法检测到它们。

Bug PH-UI-001 — Segmented button text truncation

// Compiles and runs. Level 3 sees no violation.
// The bug: Text inside MultiChoiceSegmentedButtonRow truncates because a
// fixed height modifier prevents the Roboto Flex variable font from expanding.
MultiChoiceSegmentedButtonRow {
    SegmentedButton(/* fixed height modifier */) {
        Text("Light")
    }
}

\[！注意\] 这是一个 缺席 程序错误缺少正确的修饰符——不存在错误的修饰符。使用目视测试或运行时检查。

Bug PH-UI-003 — Disabled button contrast failure

// Correct Material 3 API. Level 3 sees no violation.
// The bug: disabled state colours fail WCAG AA 4.5:1 contrast against surface.
Button(enabled = false, onClick = {}) {
    Text("INITIALIZE VAULT")
}

\[！注意\] 这是一个 运行时视觉属性 程序错误使用狗仔队截图测试或谷歌的辅助功能扫描仪。

Bug PH-AR-004 — Raw stack trace rendered to end user

// A missing try/catch produces no pattern match.
class VaultViewModel : ViewModel() {
    fun initializeVault() {
        viewModelScope.launch {
            val result = repository.initialize() // Missing try/catch
            _uiState.value = UiState.Success(result)
        }
    }
}

\[！警告\] UDF架构违规 要求Detekt使用自定义规则或单元测试来验证异常映射。

______________________________________________________________________

🗂️ 深度防御：每个Bug类的正确工具

______________________________________________________________________

🎯 杀手论

*“你能 agents.md 文件告诉我上周二发货的Gradle版本？"*

没有markdown文件可以。没有规则 .cursorrules 可以。不 SKILL.md 可以。

✅ 只有实时工具调用可以。

这就是AndroJack存在的目的——在当前的生态系统中，没有其他东西专门为Android做这件事。

快速工程控制着人工智能的反应方式。MCP控制着AI所知道的。

______________________________________________________________________

✨ AndroJack涵盖了什么——22个工具

______________________________________________________________________

🚀 快速入门——无需安装

选项1--交互式CLI（v1.7.1）✨ 推荐

npx -y androjack-mcp@1.7.1 install

启动具有自动检测功能的完整动画终端向导 VS Code、Cursor、Claude、Windsurf、JetBrains、Kiro和反重力。

选项2——目标安装

# Preview detected IDEs and config paths
npx -y androjack-mcp@1.7.1 install --list

# Auto-detect all
npx -y androjack-mcp@1.7.1 install --auto

# Install to a specific IDE
npx -y androjack-mcp@1.7.1 install --ide=cursor
npx -y androjack-mcp@1.7.1 install --ide=claude
npx -y androjack-mcp@1.7.1 install --ide=vscode
npx -y androjack-mcp@1.7.1 install --ide=windsurf
npx -y androjack-mcp@1.7.1 install --ide=jetbrains
npx -y androjack-mcp@1.7.1 install --ide=kiro
npx -y androjack-mcp@1.7.1 install --ide=antigravity

选项3——不使用IDE进行测试

npx -y @modelcontextprotocol/inspector npx -y androjack-mcp@1.7.1

______________________________________________________________________

🧩 手动配置/复制/粘贴

如果你更喜欢手动连接服务器，或者想在编写任何内容之前检查确切的JSON：

• 跑 npx -y androjack-mcp@1.7.1 install --list 预览检测到的IDE和目标配置路径。
• 即时粘贴示例 config/.

每个示例默认情况下都将AndroJack保持在本地，并通过以下方式运行已发布的包 npx -y androjack-mcp@1.7.1.

______________________________________________________________________

📍 生态系统：AndroJack与其他MCP

______________________________________________________________________

🔒 安全与隐私

______________________________________________________________________

📋 更新日志

v1.7.1--工程强化和社区平等

• 54测试覆盖率 --为验证器规则、HTML解析器、LRU缓存和HTTP安全层实现了全面的单元和契约测试。
• 发现奇偶校验 --已修复 /.well-known/mcp 正确报告的端点 tools: 22.
• 依赖性消毒 --已删除 node-fetch （迁移到本地 fetch)并修剪陈旧的覆盖物，以实现更清洁的供应链。
• 规则强化 --改进的组合组件检测 NavHost 和 BottomAppBar.
• URL修正 --修复了Android 17中损坏的文档锚点 ACCESS_LOCAL_NETWORK 和 handoff.

v1.0.0-Android 17/API 37支持

• 工具22： android_api17_compliance --Android 17平台稳定性的完整参考（2026年3月26日）。
• 31条验证器规则 --通过专用的Android 17和Room 3.0删除检查，从24个扩展到31个。
• 窗口管理器1.5.0 --添加了大（1200dp）和超大（1600dp）断点和布局模式。
• 3.0阿尔法室 --支持现代SQLiteDriver迁移路径。

______________________________________________________________________

👥 作者和所有权

维卡斯·萨哈尼 --产品负责人(vikassahani17@gmail.com)\ 克劳德AI --人工智能工程主管

______________________________________________________________________

麻省理工学院许可证©2026 Vikas Sahani| 安全.md

*之所以建立，是因为2025年Stack Overflow访问量的35%是开发人员调试AI生成的代码。*\ *AndroJack存在，所以这些访问都不是你的。*