replicant-mcp

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

👁 CI
👁 npm
👁 Node.js
👁 License: MIT
👁 Ask DeepWiki
👁 replicant-mcp MCP server

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

デモ

👁 replicant-mcp demo

Related MCP server: android-emulator-mcp

なぜreplicant-mcpなのか？

機能

今後の予定

• カスタムビルドコマンド（プロジェクト固有のオーバーライド、gradlewの自動検出）

• ビデオキャプチャ（録画の開始/停止、時間指定キャプチャ）

クイックスタート

前提条件

• Node.js 18+

• Android SDK（PATHにadbとemulatorが含まれていること）

• gradlewを含むAndroidプロジェクト（ビルドツール用）

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

インストール

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

質問がありますか？ Issueを作成してください

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• adb-appC
• adb-deviceC
• adb-logcatC
• adb-shellC
• cacheD
• emulator-deviceC
• gradle-buildD
• gradle-get-detailsC