replicant-mcp

AI가 Android 앱을 빌드, 테스트 및 디버그하도록 하세요.

replicant-mcp는 Claude와 같은 AI 어시스턴트가 사용자의 Android 개발 환경과 상호작용할 수 있도록 하는 Model Context Protocol 서버입니다. 자연스러운 대화를 통해 APK 빌드, 에뮬레이터 실행, 앱 설치, UI 탐색 및 충돌 디버깅을 수행하세요.

데모

Related MCP server: android-mcp-server

왜 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

설치

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

질문이 있으신가요? 이슈 열기