Mobile Next MCP Server

Mobile Next-用于移动开发和自动化的MCP服务器|iOS、Android、模拟器、仿真器和真实设备

这是一个 模型上下文协议（MCP）服务器 通过平台无关的界面实现可扩展的移动自动化开发，消除了对不同iOS或Android知识的需求。您可以在模拟器、模拟器和真实设备（iOS和Android）上运行它。 此服务器允许代理和LLM通过结构化的可访问性快照或基于屏幕截图的基于坐标的点击与本地iOS/Android应用程序和设备进行交互。

https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde

🚀 移动MCP路线图：构建移动的未来

加入我们的旅程，我们将不断增强移动MCP！ 查看我们的详细路线图，了解即将推出的功能、改进和里程碑。您的反馈对于塑造移动自动化的未来非常宝贵。

👉 探索路线图

主要使用案例

我们如何帮助扩展移动自动化：

• 📲 用于测试或数据输入场景的原生应用程序自动化（iOS和Android）。
• 📝 脚本流和表单交互，无需手动控制模拟器/仿真器或真实设备（iPhone、三星、谷歌Pixel等）
• 🧭 由LLM驱动的多步骤用户旅程自动化
• 👆 基于代理框架的通用移动应用交互
• 🤖 支持移动自动化用例、数据提取的代理间通信

主要特点

• 🚀 快速轻便：在大多数交互中使用本地可访问性树，或者在没有11y标签的情况下使用基于屏幕截图的坐标。
• 🤖 LLM友好：辅助功能（快照）中不需要计算机视觉模型。
• 🧿 视觉：评估和分析屏幕上实际呈现的内容，以决定下一步行动。如果可访问性数据或视图层次结构坐标不可用，则退回到基于屏幕截图的分析。
• 📊 确定性工具应用：通过尽可能依赖结构化数据，减少纯粹基于屏幕截图的方法中的歧义。
• 📺 提取结构化数据：使您能够从屏幕上可见的任何内容中提取结构化数据。

🎯 平台支持

🔧 可用的MCP工具

📱 Click to expand tool list - List of Mobile MCP tools for automation and development

有关详细的实现和参数规范，请参阅 src/server.ts

设备管理

• mobile_list_available_devices -列出所有可用设备（模拟器、仿真器和真实设备）
• mobile_get_screen_size -获取移动设备的屏幕尺寸（像素）
• mobile_get_orientation -获取设备的当前屏幕方向
• mobile_set_orientation -更改屏幕方向（纵向/横向）

应用程序管理

• mobile_list_apps -列出设备上安装的所有应用程序
• mobile_launch_app -使用程序包名称启动应用程序
• mobile_terminate_app -停止并终止正在运行的应用程序
• mobile_install_app -从文件（.apk、.ipa、.app、.zip）安装应用程序
• mobile_uninstall_app -使用捆绑包ID或包名称卸载应用程序

屏幕交互

• mobile_take_screenshot -截图以了解屏幕上的内容
• mobile_save_screenshot -将屏幕截图保存到文件
• mobile_list_elements_on_screen -列出UI元素及其坐标和属性
• mobile_click_on_screen_at_coordinates -单击特定的x、y坐标
• mobile_double_tap_on_screen -在特定坐标处双击
• mobile_long_press_on_screen_at_coordinates -在特定坐标处长按
• mobile_swipe_on_screen -向任何方向滑动（上、下、左、右）

输入和导航

• mobile_type_keys -在焦点元素中键入文本，并可选择提交
• mobile_press_button -按下设备按钮（HOME、BACK、VOLUME_UP/DOWN、ENTER等）
• mobile_open_url -在设备浏览器中打开URL

平台支持

• iOS：通过本机可访问性和WebDriver Agent实现模拟器和真实设备
• 安卓：通过ADB和UI Automator实现仿真器和真实设备
• 跨平台：统一的API适用于iOS和Android

🏗️ 移动MCP架构

📚 Wiki页面

更多详情请访问我们的 维基页面 用于设置、配置和调试相关问题。

安装和配置

标准配置 适用于大多数工具：

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"]
    }
  }
}

Amp

通过Amp VS Code扩展设置屏幕或更新您的 settings.json 文件：

"amp.mcpServers": {
  "mobile-mcp": {
    "command": "npx",
    "args": [
      "@mobilenext/mobile-mcp@latest"
    ]
  }
}

Amp CLI：

在终端中运行以下命令：

amp mcp add mobile-mcp -- npx @mobilenext/mobile-mcp@latest

Cline

要设置Cline，只需将上面的json添加到MCP设置文件中。

更多信息请访问我们的wiki

Claude Code

使用Claude Code CLI添加移动MCP服务器：

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

Claude Desktop

遵循 MCP安装指南，使用上面的json配置。

Codex

使用Codex CLI添加移动MCP服务器：

codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"

或者，创建或编辑配置文件 ~/.codex/config.toml 并添加：

[mcp_servers.mobile-mcp]
command = "npx"
args = ["@mobilenext/mobile-mcp@latest"]

有关更多信息，请参阅Codex MCP文件。

Copilot

使用Copilot CLI以交互方式添加移动MCP服务器：

/mcp add

您可以编辑配置文件 ~/.copilot/mcp-config.json 并添加：

{
  "mcpServers": {
    "mobile-mcp": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

有关更多信息，请参阅Copilot CLI文档。

Cursor

单击按钮安装：

[](https://cursor.com/en/install-mcp?name=Mobile%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb2JpbGVuZXh0L21vYmlsZS1tY3BAbGF0ZXN0Il19)

或手动安装：

首选 Cursor Settings -> MCP -> Add new MCP Server.按你的喜好命名，使用 command 使用命令键入 npx -y @mobilenext/mobile-mcp@latest。您还可以通过单击来验证配置或添加类似命令的参数 Edit.

Gemini CLI

使用Gemini CLI添加移动MCP服务器：

gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest

Goose

单击按钮安装：

或手动安装：

首选 Advanced settings -> Extensions -> Add custom extension.按你的喜好命名，使用类型 STDIO，并设置 command 到 npx -y @mobilenext/mobile-mcp@latest。单击“添加扩展名”。

Kiro

关注MCP服务器 文档例如，在 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

opencode

遵循MCP服务器文档。例如，在 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mobile-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@mobilenext/mobile-mcp@latest"
      ],
      "enabled": true
    }
  }
}

Qodo Gen

打开 Qodo Gen VSCode或IntelliJ中的聊天面板→ 连接更多工具→ + 添加新MCP→ 粘贴上面的标准配置。

点击 保存.

Windsurf

打开Windsurf设置，导航到MCP服务器，并使用添加新服务器 command 键入：

npx @mobilenext/mobile-mcp@latest

或者在下面添加标准配置 mcpServers 在如上所示的设置中。

在我们的wiki上阅读更多! 🚀

SSE服务器模式

默认情况下，Mobile MCP在stdio上运行。要启动SSE服务器，请使用 --listen 标志：

npx @mobilenext/mobile-mcp@latest --listen 3000

这与 localhost:3000。要绑定到特定接口，请执行以下操作：

npx @mobilenext/mobile-mcp@latest --listen 0.0.0.0:3000

然后配置您的MCP客户端以连接到 http://:3000/mcp.

授权

要要求SSE服务器上的承载令牌授权，请设置 MOBILEMCP_AUTH 环境变量：

MOBILEMCP_AUTH=my-secret-token npx @mobilenext/mobile-mcp@latest --listen 3000

设置后，所有请求都必须包含标头 Authorization: Bearer my-secret-token.

🛠️ 如何使用📝

将MCP服务器添加到IDE/Client后，您可以指示AI助手使用可用的工具。 例如，在Cursor的代理模式下，您可以使用下面的提示快速验证、测试和迭代UI交互，从屏幕上读取信息，完成复杂的工作流程。 描述性强，切中要害。

✨ 示例提示

工作流

您可以在单个提示中指定详细的工作流，验证业务逻辑，设置自动化。你可能会发疯：

搜索视频、发表评论、点赞并分享。

Find the video called " Beginner Recipe for Tonkotsu Ramen" by Way of
Ramen, click on like video, after liking write a comment " this was
delicious, will make it next Friday", share the video with the first
contact in your whatsapp list.

下载一个成功的步数计数器应用程序，注册，设置锻炼和五星应用程序

Find and Download a free "Pomodoro" app that has more than 1k stars.
Launch the app, register with my email, after registration find how to
start a pomodoro timer. When the pomodoro timer started, go back to the
app store and rate the app 5 stars, and leave a comment how useful the
app is.

在Substack中搜索、阅读、突出显示、评论和保存文章

Open Substack website, search for "Latest trends in AI automation 2025",
open the first article, highlight the section titled "Emerging AI trends",
and save article to reading list for later review, comment a random
paragraph summary.

预订锻炼课程，设置计时器

Open ClassPass, search for yoga classes tomorrow morning within 2 miles,
book the highest-rated class at 7 AM, confirm reservation,
setup a timer for the booked slot in the phone

查找本地事件，设置日历事件

Open Eventbrite, search for AI startup meetup events happening this
weekend in "Austin, TX", select the most popular one, register and RSVP
yes to the event, setup a calendar event as a reminder.

查看天气预报并发送Whatsapp/Telegram/Slack消息

Open Weather app, check tomorrow's weather forecast for "Berlin", and
send the summary via Whatsapp/Telegram/Slack to contact "Lauren Trown",
thumbs up their response.

• 在Zoom中安排会议，并通过电子邮件分享邀请

Open Zoom app, schedule a meeting titled "AI Hackathon" for tomorrow at
10AM with a duration of 1 hour, copy the invitation link, and send it via
Gmail to contacts "team@example.com".

更多提示示例可以在此处找到。

先决条件

将MCP与您的代理和移动设备连接需要什么：

• Xcode命令行工具
• Android平台工具
• v22+

模拟器、仿真器和真实设备

启动后，移动MCP可以连接到：

• macOS/Linux上的iOS模拟器
• Linux/Windows/macOS上的Android模拟器
• iOS或Android真实设备（需要适当的平台工具和驱动程序）

在运行mobile Next mobile MCP之前，请确保您已正确安装和配置了移动平台SDK（Xcode、Android SDK）。

遥测

移动MCP通过PostHog收集匿名使用遥测数据。要禁用它，请设置 MOBILEMCP_DISABLE_TELEMETRY 环境变量：

MOBILEMCP_DISABLE_TELEMETRY=1 npx @mobilenext/mobile-mcp@latest

对于json配置：

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"],
      "env": {
        "MOBILEMCP_DISABLE_TELEMETRY": "1"
      }
    }
  }
}

在模拟器/仿真器上以“无头”模式运行

当您的机器上没有连接真实设备时，您可以在后台使用模拟器或仿真器运行Mobile MCP。

例如，在Android上：

1. 启动模拟器（avdmanager/emulator命令）。
2. 使用所需标志运行移动MCP

在iOS上，在将Mobile MCP与模拟器实例一起使用之前，您需要Xcode和运行模拟器。

• xcrun simctl list
• xcrun simctl boot "iPhone 16"

感谢所有贡献者❤️

我们感谢所有帮助改进这个项目的人。