AlexGladkov/claude-in-mobile

MCP server for mobile and desktop automation — Android (via ADB), iOS Simulator (via simctl), and Desktop (Compose Multiplatform). Like Claude in Chrome but for mobile devices and desktop apps

`mcp-devices` / `claude‑in‑mobile` 는 무엇인가요?

모듈식 명령줄 서버 로, Anthropic Claude 기반 AI 에이전트가 실제 장치(안드로이드 폰, iOS 장치, 브라우저, 데스크톱 앱, Flutter-Aurora, HarmonyOS)와 마치 자신의 '의식' 일부인 것처럼 상호작용할 수 있게 해줍니다.

이 프로젝트는 과거에는 claude-in-mobile 라는 단일 npm 패키지로 제공되었습니다. 버전 4.0부터 핵심 기능은 mcp-devices 로 이름이 변경되었으며, 가벼운 기본 모듈과 선택적 플랫폼 플러그인 으로 분리되었습니다. 원래의 통합 패키지는 단일 설치를 선호하는 사용자를 위해 여전히 존재합니다.

작동 방식

기본 서버 설치 (npm i -g mcp-devices).
필요한 플랫폼 추가 – 예: npm i -g @mcp-devices/plugin-android 설치 후 mcp-devices install android 로 활성화.
MCP 호환 클라이언트 (Claude의 "Mobile Control Protocol" 클라이언트)를 서버에 연결하기 위해 JSON 설정에 다음 항목 추가:
```
{ "mcpServers": { "mobile": { "command": "mcp-devices" } } }
```
Claude에게 명령 – 예: "내 안드로이드 기기의 스크린샷을 찍어줘"; 서버는 ADB, Xcode, Chrome 등 적절한 도구를 통해 요청을 기기에 전달하고 결과를 반환합니다.

npm 명령어와의 이름 충돌을 피하기 위해 Homebrew를 통해 설치 가능한 네이티브 Rust CLI (mcp-devices-cli) 도 제공됩니다.

할 수 있는 일

기능	예시 작업
앱 제어	스크린샷 캡처, 탭/스와이프/입력 시뮬레이션, 앱 실행, UI 계층 구조 조회, 쉘 명령 실행, 권한 관리, 파일 전송
라이브 디버깅	브레이크포인트 설정, 코드 단계 실행, 변수 검사, 식 평가 (Android JDWP, iOS LLDB) – 선택적 `debug` 플러그인 제공
테스트	시각적 회귀 테스트, 접근성 감사, 성능 프로파일링, 센서 또는 네트워크 조건 시뮬레이션

핵심 기능은 약 20개의 내장 도구 모듈(스크린샷, 탭, UI-트리 등)을 포함하며, 디버그 플러그인은 더 깊은 진단 기능을 제공합니다.

설치 옵션

버전	선택 시기	설치 명령어
`claude-in-mobile` (통합형)	설정 없이 모든 기능이 포함된 상태를 원할 때	`npm i -g claude-in-mobile`
`mcp-devices` (모듈형)	가벼운 크기와 실제 사용하는 플랫폼만 선택하고 싶을 때	`npm i -g mcp-devices` + 플랫폼 플러그인

플랫폼 플러그인은 별도의 npm 패키지(@mcp-devices/plugin-android, @mcp-devices/plugin-ios, …)입니다. 플러그인 설치 후 mcp-devices install <name> 명령어로 활성화합니다.

누구에게 적합한가요?

워크플로우의 일부로 스마트폰, 태블릿, 데스크톱을 제어할 수 있는 AI 기반 어시스턴트를 개발하는 개발자.
LLM을 통해 실제 기기에서 UI 상호작용을 스크립트화하고 싶은 QA 엔지니어.
실제 또는 시뮬레이션된 기기에서 행동할 수 있는 몸체화된 AI 에이전트를 연구하는 연구자.

더 많은 정보 찾기

문서 – 각 플랫폼, 내장 도구, 디버그 플러그인에 대한 설명을 포함한 docs/modules/ 폴더 내 markdown 파일들.
CLI 도움말 – mcp-devices --help (Node) 또는 mcp-devices-cli --help (Rust).
건강 점검 – mcp-devices doctor 는 ADB, Xcode, Chrome 등 필수 외부 도구가 설치되어 있는지 검증합니다.

TL;DR

mcp-devices (이전 이름: claude-in-mobile)는 Node 기반 서버로, Mobile Control Protocol 을 노출하여 Claude 스타일의 LLM 에이전트가 실제 장치를 제어할 수 있도록 합니다 — 스크린샷 캡처, 탭, 디버깅, 테스트 등. 기본 설치 후 필요한 플러그인을 추가하고, Claude 클라이언트를 연결한 후 자연어 명령으로 하드웨어를 조작하기 시작하세요.