Content
# 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`
