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 エージェントが、実際のデバイス（Android フォン、iOS デバイス、ブラウザ、デスクトップアプリ、Flutter‑Aurora、HarmonyOS）と対話できるようにします。まるでその「心」の一部であるかのように。

このプロジェクトはかつて claude-in-mobile という単一の npm パッケージとして提供されていました。バージョン 4.0 以降、コア部分は mcp-devices にリネームされ、軽量なベースとオプションの プラットフォームプラグイン に分割されました。すべてを1つにまとめた元のパッケージは、単一インストールを好むユーザーのために引き続き存在します。

動作方法

ベースサーバーをインストール（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に指示：「私のAndroidデバイスのスクリーンショットを撮影して」 など。サーバーは適切なツール（ADB、Xcode、Chrome など）を介してリクエストをデバイスに転送し、結果を返します。

ネイティブの Rust CLI（mcp-devices-cli）も提供されており、Homebrew でインストール可能で、npm コマンドとの名前衝突を回避できます。

できること

機能	例の操作
アプリの操作	スクリーンショットの取得、タップ/スワイプ/入力のシミュレーション、アプリの起動、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 クライアントを接続して、自然言語でハードウェアに命令を出すことを始めましょう。