Mobile Dev MCP Server

🚀 Mobile Development MCP

Introducing the Model Context Protocol (MCP) for AI - controlled mobile devices!

This is an MCP designed for managing and interacting with mobile devices and emulators. It offers a variety of useful tools to assist with tasks such as app installation, device management, and log retrieval, and is suitable for both iOS and Android development environments.

🚀 Quick Start

This MCP provides a range of tools for mobile device management and interaction. Before starting, ensure you have the necessary tools installed and follow the setup steps to get it up and running.

✨ Features

• Device Management: Start, shut down, or list all connected devices and emulators.
• Application Management: Install APKs on devices and verify the installation status.
• File Management: Upload, download, and manage files on the device.
• Screenshots and Diagnosis: Capture screenshots and perform basic diagnostics.
• Log Retrieval: Retrieve device log information to help troubleshoot issues.

📦 Installation

Prerequisites

Before starting to use this project, make sure you have the following tools installed:

• Android Debug Bridge (ADB): Used for debugging and managing Android devices.
• Xcode Command Line Tools: Command - line tools for iOS development.
• Facebook IDB Tools: Used to interact with devices or emulators.

Setup Steps

1. Clone the repository:

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

2. Navigate to the project directory:

   cd mobile-dev-mcp-server
   

3. Build the project using the .NET SDK:

   dotnet build
   

💻 Usage Examples

Basic Usage

Run the following command to start the MCP service and test its functionality:

dotnet run

After that, you can interact with the project through the MCP Inspector tool (https://github.com/modelcontextprotocol/inspector).

Advanced Usage

Here are some example queries that you can use directly to interact with the MCP:

1. Install an APK and confirm the status:

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

2. Get device logs:

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

3. Simulate user operations:

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

📚 Documentation

Tool List

Here is an overview of some core tools:

• Install an app: install - apk
• Launch an app: launch - android - app
• Manage files: manage - files
• Take a screenshot: capture - screen
• View logs: view - logs

Contribution Guide

Contributions are welcome, whether it's fixing issues, adding new features, or improving the documentation! Here's the process to get involved:

1. Create a branch:

   git checkout -b feature/my-feature
   

2. Commit your changes:

   git commit -m 'Add a new feature'
   

3. Push the branch:

   git push origin feature/my-feature
   

4. Create a pull request

📄 License

This project is licensed under the MIT License.