Replicant MCP

复制人mcp

让AI构建、测试和调试您的Android应用程序。

 ](https://www.npmjs.com/package/replicant-mcp) ](https://nodejs.org/)   

复制人mcp是 模型上下文协议 服务器，使像Claude这样的人工智能助手能够与您的Android开发环境进行交互。构建APK、启动模拟器、安装应用程序、导航UI和调试崩溃——所有这些都是通过自然对话完成的。

______________________________________________________________________

演示

replicant-mcp demo

______________________________________________________________________

为什么要复制mcp？

______________________________________________________________________

特性

______________________________________________________________________

即将推出

• 自定义构建命令（特定于项目的替代、自动检测gradlew）
• 视频捕获（开始/停止录制，基于持续时间的捕获）

______________________________________________________________________

快速开始

先决条件

• Node.js 18+
• 安卓模拟器 随着 adb 和 emulator 在你的路径中
• 一个Android项目 gradlew （用于构建工具）

node --version      # Should be 18+
adb --version       # Should show Android Debug Bridge version
emulator -version   # Should show Android emulator version

Installing prerequisites (macOS via Homebrew)

如果您还没有这些工具，请使用 家酿:

Node.js 18+

brew install node

仅限物理设备 --只是 adb，如果您从未运行过模拟器，则足够了：

brew install --cask android-platform-tools

adb 直接降落在您的路径上；无需进一步配置。

完整的Android SDK --模拟器工作流程或通过构建APK所需 gradle-* 工具。按顺序运行以下步骤：

# 1. JDK — required by sdkmanager itself, and by the gradle-* tools
brew install --cask temurin@17

# 2. cmdline-tools (provides sdkmanager)
brew install --cask android-commandlinetools

# 3. Set ANDROID_HOME and create the directory BEFORE running sdkmanager,
#    otherwise sdkmanager has no install target.
export ANDROID_HOME="$HOME/Library/Android/sdk"
mkdir -p "$ANDROID_HOME"

# 4. Accept all SDK licenses first, then install packages.
#    `sdkmanager --install` aborts on unaccepted per-package licenses
#    (e.g. the Google APIs system image) if licenses aren't accepted first.
#    The system-image arch must match your host: `arm64-v8a` for Apple
#    Silicon (M1/M2/M3), `x86_64` for Intel Macs. Check with `uname -m`.
yes | sdkmanager --licenses
sdkmanager --install "platform-tools" "emulator" "system-images;android-34;google_apis;arm64-v8a"

坚持 ANDROID_HOME 并将SDK二进制文件附加到PATH中 ~/.zshrc （或 ~/.bashrc):

export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH"

安装

npm install -g replicant-mcp

安装后，运行内置诊断程序以验证您的环境：

replicant doctor

更新

npm update -g replicant-mcp

______________________________________________________________________

设置

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

克劳德代码

claude mcp add replicant -- npx -y replicant-mcp

光标

添加 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目）：

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "replicant": {
      "command": "npx",
      "args": ["-y", "replicant-mcp"]
    }
  }
}

OpenAI Codex命令行界面

添加 ~/.codex/config.toml:

[mcp_servers.replicant]
command = "npx"
args = ["-y", "replicant-mcp"]

或者通过CLI：

codex mcp add replicant -- npx -y replicant-mcp

注： 确保 adb 和 emulator 在您的路径中，或已设置 ANDROID_HOME 环境变量。在macOS上： ~/Library/Android/sdk，在Linux上： ~/Android/Sdk.

______________________________________________________________________

示例

You: "I just changed the checkout flow. Build the app, go through checkout
      with a test product, and make sure the confirmation screen shows up."

Claude: [Builds debug APK, installs on emulator, launches app]
        [Taps "Electronics" category → "Wireless Headphones" → "Add to Cart"]
        [Navigates to cart, taps "Checkout"]
        [Fills shipping form, taps "Place Order"]

        Confirmation screen is showing:
        - Order #38291
        - "Wireless Headphones" × 1
        - Total: $79.99
        - Estimated delivery: Jan 30

        The flow works. Want me to test the edge cases—empty cart,
        invalid address, payment failure?

______________________________________________________________________

设计

复制人mcp使用渐进式披露（先总结，按需提供详细信息）来最大限度地减少令牌使用，并使用可访问性优先的UI自动化来实现比基于屏幕截图的方法更快、更便宜、更可靠的交互。看 docs/architecture.md 了解详情。

______________________________________________________________________

更多信息

• 配置： 集 REPLICANT_CONFIG 高级选项。看 docs/configuration.md.
• 登录中： 集 REPLICANT_LOG_LEVEL (error, warn, info, debug)以及 REPLICANT_LOG_FORMAT (json 用于结构化输出）以控制服务器日志记录。日志被写入stderr。
• 故障排除： 常见问题和解决方案 docs/故障排除.md.
• 工具文档： 让克劳德打电话 rtfm 使用“构建”、“adb”、“模拟器”或“ui”等类别。

______________________________________________________________________

文档

______________________________________________________________________

贡献

看 贡献.md 用于开发设置和指南。

______________________________________________________________________

致谢

• 灵感来自 xc-mcp 适用于iOS
• 建立在 模型上下文协议

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

问题？ 打开一个问题