Repolode
mobile-next

mobile-next/mobile-mcp

让 AI 智能体和 LLM 通过 MCP 协议自动操作 iOS、Android 模拟器、模拟器及真机应用的服务器。

Star
9,755
Fork
867
未关闭 Issue
61
最近提交
前天

这是什么?

Mobile MCP 是一个 Model Context Protocol 服务器,让 AI 智能体和 LLM 能以统一的方式操作原生 iOS 和 Android 应用,无需针对每个平台单独编写 XCUITest 或 Espresso 代码。同一套工具可用于 iOS 模拟器、Android 模拟器以及 iOS、Android 真机。

它主要基于原生无障碍树(accessibility tree)获取结构化的界面元素进行操作,必要时退回到截图加坐标点击。工具集涵盖设备管理、应用安装与启动、手势、硬件按键、深层链接、屏幕录制、剪贴板、设备日志和崩溃报告等。服务器既可通过 stdio 运行,也可以作为 Streamable HTTP 服务启动,并支持可选的 Bearer Token 鉴权。

它兼容 Claude Code、Cursor、Codex、Gemini CLI、Claude Desktop 等 MCP 客户端。如需云端真机,可使用其官方服务 Mobile Next Cloud。

核心功能

  • 01优先通过原生无障碍树读取界面元素,必要时回退到截图与坐标操作
  • 02同一套工具适用于 iOS 模拟器、Android 模拟器和真机
  • 03支持应用安装启动、手势、硬件按键、深层链接和屏幕方向切换
  • 04提供屏幕录制、设备日志和崩溃报告获取
  • 05支持 stdio 与 Streamable HTTP 两种运行方式,HTTP 模式可选 Bearer Token 鉴权

适用场景

  • 让 LLM 智能体在移动应用上执行多步骤的端到端测试流程
  • 自动化原生应用中重复的表单填写或数据录入
  • 在 AI 编程助手中交互式地探索应用行为
  • 结合模拟器或云端真机,在 CI 中运行移动自动化任务

快速上手

  1. 1

    安装 Node.js v20 或更高版本

  2. 2

    连接 iOS 或 Android 设备,或启动模拟器/仿真器

  3. 3

    使用标准配置将 MCP 服务器添加到你的智能体中(由 npx 运行)

    npx -y @mobilenext/mobile-mcp@latest

使用前须知

  • iOS 需要 Xcode 命令行工具,Android 需要 Android Platform Tools。
  • 需要 Node.js v20 或更高版本。
  • 部分功能(如设备镜像)仅适用于在 Ghostty 或 kitty 中运行的 Claude Code。

标签

常见问题

mobile-mcp 是什么?
让 AI 智能体和 LLM 通过 MCP 协议自动操作 iOS、Android 模拟器、模拟器及真机应用的服务器。 Mobile MCP 是一个 Model Context Protocol 服务器,让 AI 智能体和 LLM 能以统一的方式操作原生 iOS 和 Android 应用,无需针对每个平台单独编写 XCUITest 或 Espresso 代码。同一套工具可用于 iOS 模拟器、Android 模拟器以及 iOS、Android 真机。
mobile-mcp 可以免费使用吗?用的什么许可证?
mobile-mcp 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
mobile-mcp 还在维护吗?
活跃维护中。mobile-mcp 最近一次提交是在 2026年10月18日。
mobile-mcp 适合用来做什么?
让 LLM 智能体在移动应用上执行多步骤的端到端测试流程 自动化原生应用中重复的表单填写或数据录入 在 AI 编程助手中交互式地探索应用行为 结合模拟器或云端真机,在 CI 中运行移动自动化任务
mobile-mcp 怎么安装和运行?
安装 Node.js v20 或更高版本 连接 iOS 或 Android 设备,或启动模拟器/仿真器 使用标准配置将 MCP 服务器添加到你的智能体中(由 npx 运行): npx -y @mobilenext/mobile-mcp@latest
在哪里获取 mobile-mcp?
源代码和安装说明在 GitHub 上:https://github.com/mobile-next/mobile-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目