replicant-mcp 是一个面向 Android 开发的 Model Context Protocol（MCP）服务器，让 AI 助手（如 Claude）能够通过自然语言与 Android 开发环境进行交互。它的主要用途是帮助 AI 构建、测试和调试 Android 应用，覆盖从构建 APK、启动模拟器、安装应用、浏览 UI 到调试崩溃的完整流程。
主要能力包括：自定义构建命令（支持项目特定覆盖、自动检测 gradlew）、视频捕获（开始/停止录制、基于时长的捕获）、物理设备与模拟器管理、通过 adb 进行设备操作，以及基于无障碍（accessibility-first）的 UI 自动化。该工具采用渐进式披露（progressive disclosure）机制，先提供摘要再按需提供详情，以最小化令牌使用；同时无障碍优先的 UI 自动化相比基于截图的方式更快、更经济且更可靠。
使用方式：需要 Android SDK（含 adb 和 emulator）并确保其在 PATH 中，同时需要一个包含 gradlew 的 Android 项目。若工具未安装，可通过 Homebrew 安装。仅使用物理设备时只需 adb，adb 会直接加入 PATH，无需额外配置；完整 Android SDK（用于模拟器工作流或通过 gradle-* 工具构建 APK）需按顺序执行安装步骤，并将 ANDROID_HOME 持久化并追加到 ~/.zshrc 或 ~/.bashrc 的 PATH 中。安装后运行内置诊断验证环境。配置方式：Claude Desktop 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）；Cursor 编辑 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）；Windsurf 编辑 ~/.codeium/windsurf/mcp_config.json；OpenAI Codex CLI 编辑 ~/.codex/config.toml。需确保 adb 和 emulator 在 PATH 中，或设置 ANDROID_HOME 环境变量（macOS: ~/Library/Android/sdk；Linux: ~/Android/Sdk）。
配置与日志：可通过 REPLICANT_CONFIG 设置高级选项；通过 REPLICANT_LOG_LEVEL（error、warn、info、debug）和 REPLICANT_LOG_FORMAT（json 为结构化输出）控制服务器日志，日志写入 stderr。故障排除参见 docs/troubleshooting.md；工具文档可让 Claude 调用 rtfm 并指定类别如 "build"、"adb"、"emulator" 或 "ui"。开发设置和指南参见 CONTRIBUTING.md。
适用场景：需要 AI 辅助进行 Android 应用构建、测试、UI 自动化与调试的开发者，尤其是希望减少令牌消耗并提高 UI 交互可靠性的场景。
限制：该工具需要 Android SDK 环境（adb、emulator）以及包含 gradlew 的 Android 项目；部分功能（如模拟器、构建 APK）需要完整 SDK。关于收费、价格、平台支持等未在提供资料中说明，暂未提供。
