Mobile Development MCP

通过模型上下文协议，使用 AI 控制移动设备！

这是一个 MCP，旨在管理和交互移动设备和模拟器。它为 iOS 和 Android 开发环境提供诸如应用安装、设备管理和日志检索等任务的实用程序。

功能

• 设备管理: 启动、关闭或列出已连接的设备和模拟器。
• 应用管理: 在目标设备上安装、启动或管理应用程序。
• 可视化诊断: 截取设备和模拟器屏幕的屏幕截图。
• 文件管理: 无缝地将文件推送到已连接的设备或从已连接的设备拉取文件。
• UI 自动化: 通过点击、滑动、文本输入与设备交互。
• 日志管理: 从已连接的设备检索日志文件和系统信息。
• 跨平台支持: 支持 Android 和 iOS 环境。

前提条件

要使用此服务器，请确保您的开发机器上安装了以下工具：

• 用于 Android 设备管理的 ADB (Android Debug Bridge)。
• 用于 iOS 模拟器管理的 Xcode 命令行工具 (xcrun simctl)。
• Facebook IDB 工具 (参见安装指南) (仅在 iOS 上进行 UI 自动化时需要)。
• .NET SDK (例如，.NET 9)

设置

1. 克隆此存储库
2. 导航到项目目录
3. 构建项目: dotnet build
4. 使用 VS Code 或其他客户端进行配置：

"mcp-server-mobiledev": {
    "type": "stdio",
    "command": "dotnet",
    "args": [
        "run",
        "--project",
        "/Users/jsuarezruiz/GitHub/mobile-dev-mcp-server/src/MobileDevMcpServer.csproj"
    ]
}

测试

MCP Inspector 是一个交互式开发者工具，专为测试和调试 MCP 服务器而设计。可以使用 nodejs 命令 npx 从我们的应用程序文件夹启动 inspector，命令如下：

npx @modelcontextprotocol/inspector dotnet run

工具

• android_list_devices: 检索所有已连接的 Android 设备的详细信息。
• android_list_packages: 列出特定 Android 设备上安装的所有应用程序。
• android_install_app: 将应用程序 (APK) 安装到 Android 设备上。
• android_launch_app: 在 Android 设备上启动特定的应用程序。
• android_diagnostics_bug_report: 从 Android 设备捕获全面的错误报告。
• android_logs_logcat: 使用 logcat 从 Android 设备获取系统日志。
• android_logs_logcat_log_level: 通过日志级别使用 logcat 从 Android 设备获取系统日志。
• android_files_push: 将本地文件推送到 Android 设备。
• android_files_pull: 将文件从 Android 设备拉取到本地机器。
• android_files_delete_file: 此工具允许您从连接的 Android 设备中删除指定的文件。
• android_ui_tap: 模拟在 Android 设备上指定屏幕坐标处的点击操作。
• android_ui_swipe: 模拟在 Android 设备屏幕上两点之间的滑动操作。
• android_ui_input_text: 模拟在 Android 设备上的字段中输入文本。
• android_ui_press_key: 使用 Android 设备的序列号和键码模拟在其上按下按键。
• android_screenshot: 从指定的 Android 设备捕获屏幕截图。
• android_compare_screenshot_llm: 使用提供的提示以及与大型语言模型 (LLM) 的交互来比较两个屏幕截图。
• android_shell_command: 在 Android 设备上运行 shell 命令。
• ios_list_devices: 检索所有已连接的 iOS 模拟器设备的详细信息。
• ios_booted_device: 检索第一个启动的模拟器设备的名称和 ID。
• ios_boot_device: 启动指定的 iOS 模拟器设备。
• ios_launch_app: 在指定的 iOS 模拟器设备上启动应用程序。
• ios_shutdown_device: 关闭指定的 iOS 模拟器设备。
• ios_ui_tap: 模拟在 iOS 设备上指定屏幕坐标处的点击操作。
• ios_ui_swipe: 模拟在 iOS 设备屏幕上两点之间的滑动操作。
• ios_ui_input_text: 模拟在 iOS 设备上的字段中输入文本。
• ios_ui_press_key: 模拟在 iOS 设备上按下特定键。
• ios_screenshot: 从指定的 iOS 设备捕获屏幕截图。
• ios_video_start: 录制 iOS 模拟器的视频。
• ios_video_stop: 停止模拟器视频录制。

示例 AI 助手查询

尝试以下查询：

• "显示当前连接的所有 Android 设备，并提供其详细信息。"
• "显示所有已连接的 iOS 设备及其规格。"
• "分析最近的日志，并确定是否存在任何错误消息。"
• "在此设备上安装此 APK，并确认是否已正确安装。"
• "提供我手机上安装的所有应用程序的列表。"
• "按下位于坐标 (100, 1000) 的 Home 按钮。"

画廊

<img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/tool-list-vscode.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/list-ios-simulators.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/list-android-apps.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/diagnostics-android.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/launch-android-app.png" width="30%"></img> <img src="https://raw.githubusercontent.com/jsuarezruiz/mobile-dev-mcp-server/refs/heads/main/images/logs-android.png" width="30%"></img>

贡献

我非常欢迎贡献，以帮助改进这个项目！ 无论是修复错误、添加新功能还是增强文档，您的支持都将不胜感激。

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/my-feature)
3. 进行更改
4. 提交您的更改 (git commit -m 'Add a new feature')
5. 推送到分支 (git push origin feature/my-feature)
6. 打开 Pull Request

许可证

本项目根据 MIT 许可证提供。