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 開源協議。