mcp-registry/mobile-mcp

    ==================
      
       /// MCP ///
      /// MOB ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mobile-mcp

by mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

1.6k
146
Open Source
GitHubWebsiteDocumentation

Installation

1. Prerequisites
• Node.js ≥ 18 and npm ≥ 9
• Java 11+ (for Android tooling)
• Xcode ≥ 15 (macOS only – required for iOS simulators / real devices)
• ANDROID_HOME, JAVA_HOME and (on macOS) DEVELOPER_DIR environment variables configured
• At least one of the following device targets prepared:
– Android emulator (AVD) – Android real device (USB / Wi-Fi debug) – iOS simulator (Xcode) – iOS real device (USB / Wi-Fi, developer provisioning)
2. Install the MCP server package
# create a new project folder mkdir mobile-mcp-server && cd mobile-mcp-server # initialise node project if needed npm init -y # install the server and typings npm install --save @mobile-next/mcp # or, if cloning this repository directly git clone https://github.com/mobile-next/mobile-mcp.git cd mobile-mcp npm install
3. Build the TypeScript sources (repo version only)
npm run build # compiles src/**/*.ts into dist/
4. Start the server
# default port 4723 – override with MCP_PORT npm start MCP_PORT=5000 npm start # example custom port
5. Verify
curl http://localhost:4723/status # → should return server version, uptime and connected device list
6. Optional configuration (env vars or .env file)
MCP_PORT=4723 # TCP port MCP_LOG_LEVEL=info|debug|trace # logging detail MCP_SESSION_TIMEOUT=300000 # ms until inactive session removed ANDROID_SDK_ROOT=/path/to/sdk # fallback if ANDROID_HOME not set IOS_DEVICES="auto" # let MCP detect usb/wifi devices automatically
7. Updating
npm update @mobile-next/mcp

Documentation

License: Apache License 2.0
Updated 7/30/2025

Table of Contents