Mobile Dev MCP Server

🚀 移动开发 MCP

移动开发 MCP（Model Context Protocol，模型上下文协议）是专为移动设备及模拟器管理与交互而设计的工具。它提供了一系列实用功能，可实现应用安装、设备管理、日志检索等操作，广泛适用于 iOS 和 Android 开发环境。

🚀 快速开始

移动开发 MCP 能借助 AI 控制移动设备，通过一系列实用工具，可完成应用安装、设备管理及日志检索等任务。在使用前，需确保已安装相关工具，然后按设置步骤操作，即可启动服务并进行功能测试。

✨ 主要特性

• 设备管理：可启动、关闭或列出所有连接的设备和模拟器。
• 应用程序管理：能在设备上安装 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）与项目交互。

高级用法

以下是一些示例查询，您可以直接使用这些命令与 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)."
   

📚 详细文档

工具列表

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

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

贡献指南

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

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 开源协议。