@mobilenext/mobile-mcp 1.0.7 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +15 -1
- package/README.md +15 -1
- package/README.zh-CN.md +15 -1
- package/package.json +1 -1
package/README.ja.md
CHANGED
|
@@ -58,6 +58,11 @@ https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde
|
|
|
58
58
|
- 🧠 **プラットフォームの専門知識は不要**: XCUITest も Espresso もプラットフォームごとのつなぎコードも不要です。目的を伝えればエージェントが実行します。
|
|
59
59
|
- 🧰 **完全なデバイス制御**: タップ、スワイプ、ジェスチャー、アプリのインストール / 起動 / 終了、画面録画、ハードウェアボタン、ディープリンク、画面の向き。
|
|
60
60
|
- 📊 **構造化された決定的な出力**: 実際の UI 要素を読み取って構造化データを抽出し、スクリーンショットのみのアプローチにありがちな曖昧さを削減します。
|
|
61
|
+
- 🪞 **Claude Code でのデバイスミラーリング**: Ghostty または kitty で動作する Claude Code 向けです。プラグインをインストールして `/mobile-mirror` を実行すると、デバイスのライブ画面がサイドペインに表示され、ターミナルを離れずにタップ、文字入力、Home/Back の操作ができます。
|
|
62
|
+
|
|
63
|
+
<p align="center">
|
|
64
|
+
<img alt="/mobile-mirror showing an iOS simulator beside a Claude Code session" src="docs/screenshots/mobile-mirror.png" width="800" />
|
|
65
|
+
</p>
|
|
61
66
|
|
|
62
67
|
### 🎯 対応プラットフォーム
|
|
63
68
|
|
|
@@ -208,7 +213,16 @@ Cline をセットアップするには、上記の json を MCP 設定ファイ
|
|
|
208
213
|
<details>
|
|
209
214
|
<summary>Claude Code</summary>
|
|
210
215
|
|
|
211
|
-
Claude Code
|
|
216
|
+
Claude Code 内でプラグインをインストールします。Mobile MCP サーバーと `/mobile-mirror` が追加されます:
|
|
217
|
+
|
|
218
|
+
```
|
|
219
|
+
/plugin marketplace add mobile-next/mobile-mcp
|
|
220
|
+
/plugin install mobile-mcp@mobile-mcp
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
`/mobile-mirror [device-id]` を実行すると、デバイスのライブ画面を表示するペインが開きます。画像をクリックするとタップ、キー入力でキーを送信でき、上部の Home、Back、App Switch、URL ボタンも使えます。画像の表示には kitty や Ghostty など、kitty グラフィックスプロトコルに対応したターミナルが必要です。
|
|
224
|
+
|
|
225
|
+
プラグインを使えない場合は、Claude Code CLI で MCP サーバーのみを追加します:
|
|
212
226
|
|
|
213
227
|
```bash
|
|
214
228
|
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
|
package/README.md
CHANGED
|
@@ -58,6 +58,11 @@ How we help to scale mobile automation:
|
|
|
58
58
|
- 🧠 **No platform expertise required**: no XCUITest, no Espresso, no per-platform glue — describe the goal and the agent does it.
|
|
59
59
|
- 🧰 **Full device control**: taps, swipes, and gestures; app install/launch/terminate; screen recording; hardware buttons; deep links; orientation.
|
|
60
60
|
- 📊 **Structured, deterministic output**: reads real UI elements and extracts structured data, cutting the ambiguity of screenshot-only approaches.
|
|
61
|
+
- 🪞 **Device mirroring in Claude Code**: for Claude Code running in Ghostty or kitty. Install the plugin and run `/mobile-mirror` to see the device's live screen in a side pane, then tap, type and press Home/Back without leaving the terminal.
|
|
62
|
+
|
|
63
|
+
<p align="center">
|
|
64
|
+
<img alt="/mobile-mirror showing an iOS simulator beside a Claude Code session" src="docs/screenshots/mobile-mirror.png" width="800" />
|
|
65
|
+
</p>
|
|
61
66
|
|
|
62
67
|
### 🎯 Platform Support
|
|
63
68
|
|
|
@@ -209,7 +214,16 @@ To setup Cline, just add the json above to your MCP settings file.
|
|
|
209
214
|
<details>
|
|
210
215
|
<summary>Claude Code</summary>
|
|
211
216
|
|
|
212
|
-
|
|
217
|
+
Install the plugin from inside Claude Code. It adds the Mobile MCP server and `/mobile-mirror`:
|
|
218
|
+
|
|
219
|
+
```
|
|
220
|
+
/plugin marketplace add mobile-next/mobile-mcp
|
|
221
|
+
/plugin install mobile-mcp@mobile-mcp
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
`/mobile-mirror [device-id]` opens a pane with the device's live screen. Click the picture to tap, type to send keys, and use the Home, Back, App Switch and URL buttons above it. The picture needs a terminal with the kitty graphics protocol, such as kitty or Ghostty.
|
|
225
|
+
|
|
226
|
+
If you can't use plugins, add only the MCP server with the Claude Code CLI:
|
|
213
227
|
|
|
214
228
|
```bash
|
|
215
229
|
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
|
package/README.zh-CN.md
CHANGED
|
@@ -58,6 +58,11 @@ https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde
|
|
|
58
58
|
- 🧠 **无需平台专业知识**: 不需要 XCUITest,不需要 Espresso,也不需要各平台的胶水代码 —— 描述目标,智能体来完成。
|
|
59
59
|
- 🧰 **完整的设备控制**: 点击、滑动与手势;应用安装/启动/终止;屏幕录制;硬件按键;深度链接;屏幕方向。
|
|
60
60
|
- 📊 **结构化、确定性的输出**: 读取真实的 UI 元素并提取结构化数据,减少纯截图方案带来的歧义。
|
|
61
|
+
- 🪞 **在 Claude Code 中镜像设备**: 适用于在 Ghostty 或 kitty 中运行的 Claude Code。安装插件后运行 `/mobile-mirror`,即可在侧边窗格中查看设备的实时画面,并且无需离开终端就能点按、输入文字以及按 Home/Back。
|
|
62
|
+
|
|
63
|
+
<p align="center">
|
|
64
|
+
<img alt="/mobile-mirror showing an iOS simulator beside a Claude Code session" src="docs/screenshots/mobile-mirror.png" width="800" />
|
|
65
|
+
</p>
|
|
61
66
|
|
|
62
67
|
### 🎯 平台支持
|
|
63
68
|
|
|
@@ -208,7 +213,16 @@ Antigravity 没有添加 MCP 服务器的 CLI 命令,因此需要手动添加
|
|
|
208
213
|
<details>
|
|
209
214
|
<summary>Claude Code</summary>
|
|
210
215
|
|
|
211
|
-
|
|
216
|
+
在 Claude Code 中安装插件,它会添加 Mobile MCP 服务器和 `/mobile-mirror`:
|
|
217
|
+
|
|
218
|
+
```
|
|
219
|
+
/plugin marketplace add mobile-next/mobile-mcp
|
|
220
|
+
/plugin install mobile-mcp@mobile-mcp
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
`/mobile-mirror [device-id]` 会打开一个显示设备实时画面的窗格。点击画面即可点按设备,输入文字即可发送按键,上方还有 Home、Back、App Switch 和 URL 按钮。显示画面需要支持 kitty 图形协议的终端,例如 kitty 或 Ghostty。
|
|
224
|
+
|
|
225
|
+
如果无法使用插件,可以用 Claude Code CLI 只添加 MCP 服务器:
|
|
212
226
|
|
|
213
227
|
```bash
|
|
214
228
|
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
|