replicant-mcp

replicant-mcp

AI に Android アプリのビルド、テスト、デバッグを任せましょう。

replicant-mcp は、Claude のような AI アシスタントが Android の開発環境を操作できるようにする Model Context Protocol サーバーです。APK のビルド、エミュレーターの起動、アプリのインストール、UI の操作、クラッシュのデバッグを、すべて自然な会話を通じて行えます。

デモ

replicant-mcp を使う理由

機能

近日公開予定

• カスタムビルドコマンド（プロジェクト固有のオーバーライド、gradlew の自動検出）
• 動画キャプチャ（録画の開始／停止、時間指定キャプチャ）

クイックスタート

前提条件

• Node.js 18+
• PATH に adb と emulator が設定された Android SDK
• gradlew を含む Android プロジェクト（ビルドツール用）

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

brew install node

brew install --cask android-platform-tools

# 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"

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

セットアップ

Claude Desktop

~/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 Code

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

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加してください。

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

Windsurf

~/.codeium/windsurf/mcp_config.json に追加してください。

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

OpenAI Codex CLI

~/.codex/config.toml に追加します：

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

または、CLI を使用します：

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

注記： adb と emulator が PATH に含まれていることを確認するか、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?

設計

replicant-mcp は、トークン使用量を最小限に抑えるため、段階的な情報開示（まず概要を示し、必要に応じて詳細を提示）を採用しています。また、スクリーンショットベースの方法よりも高速で、低コストかつ信頼性の高い操作を実現するため、アクセシビリティを最優先した UI 自動化を使用しています。詳しくは docs/architecture.md を参照してください。

詳細情報

• 設定： 高度なオプションを設定するには REPLICANT_CONFIG を設定してください。docs/configuration.md を参照してください。
• ログ： サーバーのログ出力を制御するには、REPLICANT_LOG_LEVEL（error、warn、info、debug）と REPLICANT_LOG_FORMAT（構造化出力の場合は json）を設定してください。ログは stderr に書き込まれます。
• トラブルシューティング： よくある問題と解決策については、docs/troubleshooting.md を参照してください。
• ツールドキュメント： Claude に「build」、「adb」、「emulator」、「ui」などのカテゴリを指定して rtfm を呼び出すよう依頼してください。

ドキュメント

貢献

開発環境のセットアップとガイドラインについては、CONTRIBUTING.md を参照してください。

謝辞

• iOS 向けの xc-mcp に着想を得ています
• Model Context Protocol 上に構築されています

ライセンス

MIT

ご質問はありますか？ イシューを作成