mcp-mumu

MCP Server for AI agents to control MuMu Player 12 (Netease) Android Emulator. 59 tools for emulator lifecycle, app management, UI automation, screenshots, and more.

Requirements

• Python >= 3.10
• MuMu Player 12 installed
• mcp>=1.0.0

Install

pip install -e .

Run

mcp-mumu
mcp-mumu --mumu-path "D:\Path\To\MuMuPlayer\nx_main"
mcp-mumu --list-tools

MCP Config

{
  "mcp": {
    "mcp-mumu": {
      "type": "local",
      "command": ["mcp-mumu"],
      "enabled": true
    }
  }
}

With custom MuMu path:

{
  "mcp": {
    "mcp-mumu": {
      "type": "local",
      "command": ["mcp-mumu", "--mumu-path", "C:\\Program Files\\Netease\\MuMuPlayer\\nx_main"],
      "enabled": true
    }
  }
}

Tools

Lifecycle — mumu_list mumu_create mumu_clone mumu_delete mumu_start mumu_stop mumu_reboot

Config — mumu_settings_get mumu_settings_get_writable mumu_settings_set mumu_set_resolution mumu_set_cpu mumu_set_ram mumu_set_device mumu_spoof_identity mumu_set_root mumu_set_fps

Apps — mumu_app_install mumu_app_uninstall mumu_app_launch mumu_app_close mumu_app_info mumu_app_list mumu_app_clear_data

UI — mumu_tap mumu_swipe mumu_long_press mumu_text_input mumu_key_event mumu_press_home mumu_press_back mumu_press_recent mumu_scroll_down mumu_scroll_up mumu_rotate mumu_rotate_reset mumu_volume mumu_shake

Screenshot — mumu_screenshot mumu_screenshot_base64 mumu_screen_size

Network — mumu_network_info mumu_public_ip mumu_gps_set mumu_airplane_mode mumu_wifi_toggle

Shell — mumu_shell mumu_push mumu_pull mumu_logcat mumu_prop_get mumu_prop_set mumu_export mumu_import

Compound — mumu_boot_ready mumu_fresh_start_app mumu_batch_install mumu_monkey_test mumu_rename