AlexGladkov/claude-in-mobile

什么是 mcp-devices / claude‑in‑mobile？

一个模块化的命令行服务器，让基于 Anthropic Claude 的 AI 代理能够与真实设备（Android 手机、iOS 设备、浏览器、桌面应用、Flutter-Aurora 和 HarmonyOS）交互，仿佛这些设备是其“心智”的一部分。

该项目曾以单一 npm 包 claude-in-mobile 的形式发布。从版本 4.0 开始，核心被重命名为 mcp-devices，并拆分为轻量级基础模块和可选的 平台插件。原有的全功能包仍然存在，供偏好单次安装的用户使用。

---

工作原理

1. 安装基础服务器（npm i -g mcp-devices）。
2. 添加所需平台——例如安装 npm i -g @mcp-devices/plugin-android，然后通过 mcp-devices install android 启用。
3. 将你的 MCP 兼容客户端（Claude 的“Mobile Control Protocol”客户端）指向服务器，添加如下 JSON 配置项：

   { "mcpServers": { "mobile": { "command": "mcp-devices" } } }
   

4. 让 Claude 执行操作，例如 “拍摄我的 Android 设备的屏幕截图”；服务器会通过 ADB、Xcode、Chrome 等工具将请求转发到设备，并返回结果。

还提供了一个原生 Rust CLI（mcp-devices-cli），可通过 Homebrew 安装，避免与 npm 命令名称冲突。

---

可以做什么

能力	示例操作
驱动应用	捕获截图、模拟点击/滑动/输入、启动应用、查询 UI 层级、运行 shell 命令、管理权限、传输文件
实时调试	设置断点、单步执行代码、检查变量、评估表达式（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 客户端指向它，即可开始用自然语言向硬件发出指令。