# 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

```bash
pip install -e .
```

## Run

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

## MCP Config

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

With custom MuMu path:

```json
{
  "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`