移动开发 MCP

通过 AI 控制移动设备：Model Context Protocol（模型上下文协议）简介！

这是一个专为管理与交互移动设备及模拟器设计的 MCP。它提供了多种实用工具，可帮助完成应用安装、设备管理以及日志检索等任务，适用于 iOS 和 Android 开发环境。

功能

• 设备管理：启动、关闭或列出所有连接的设备和模拟器。
• 应用程序管理：在设备上安装 APK 并验证安装状态。
• 文件管理：上传、下载和管理设备上的文件。
• 截图与诊断：捕获屏幕快照并进行基本诊断。
• 日志检索：获取设备的日志信息，帮助排查问题。

预置条件

在开始使用本项目之前，请确保已安装以下工具：

1. Android Debug Bridge (ADB)：用于 Android 设备的调试和管理。
2. Xcode Command Line Tools：用于 iOS 开发的命令行工具。
3. Facebook IDB 工具：用于与设备或模拟器进行交互。

设置步骤

1. 克隆仓库：

   git clone https://github.com/jsuarezruiz/mobile-dev-mcp-server.git
   

2. 导航到项目目录：

   cd mobile-dev-mcp-server
   

3. 使用 .NET SDK 构建项目：

   dotnet build
   

测试指南

运行以下命令启动 MCP 服务并测试功能：

dotnet run

随后，您可以通过 MCP Inspector 工具（https://github.com/modelcontextprotocol/inspector）与项目交互。

工具列表

以下是部分核心工具的概述：

• 安装应用：install-apk
• 启动应用：launch-android-app
• 管理文件：manage-files
• 截取屏幕：capture-screen
• 查看日志：view-logs

示例 AI 助手查询

以下是一些示例查询，您可以直接使用这些命令与 MCP 交互：

1. 安装 APK 并确认状态：

   "Install this APK on my device and confirm whether it was installed correctly."
   

2. 获取设备日志：

   "Provide a list of all applications installed on my phone."
   

3. 模拟用户操作：

   "Press the Home button located at the coordinates (100, 1000)."
   

贡献指南

欢迎任何贡献，无论是修复问题、添加新功能还是完善文档！以下是参与流程：

1. 创建分支：

   git checkout -b feature/my-feature
   

2. 提交更改：

   git commit -m 'Add a new feature'
   

3. 推送分支：

   git push origin feature/my-feature
   

4. 创建拉取请求

许可证

本项目采用 MIT License 开源协议。