内容
# mcp-mumu
用于控制 MuMu 模拟器 12（网易）安卓模拟器的 AI 代理的 MCP 服务器。模拟器生命周期、应用管理、UI 自动化、截图等 59 种工具。
## 要求
- Python >= 3.10
- 已安装 MuMu 模拟器 12
- `mcp>=1.0.0`
## 安装
```bash
pip install -e .
```
## 运行
```bash
mcp-mumu
mcp-mumu --mumu-path "D:\Path\To\MuMuPlayer\nx_main"
mcp-mumu --list-tools
```
## MCP 配置
```json
{
"mcp": {
"mcp-mumu": {
"type": "local",
"command": ["mcp-mumu"],
"enabled": true
}
}
}
```
自定义 MuMu 路径：
```json
{
"mcp": {
"mcp-mumu": {
"type": "local",
"command": ["mcp-mumu", "--mumu-path", "C:\\Program Files\\Netease\\MuMuPlayer\\nx_main"],
"enabled": true
}
}
}
```
## 工具
**生命周期** — `mumu_list` `mumu_create` `mumu_clone` `mumu_delete` `mumu_start` `mumu_stop` `mumu_reboot`
**配置** — `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`
**应用** — `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`
**截图** — `mumu_screenshot` `mumu_screenshot_base64` `mumu_screen_size`
**网络** — `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`
**复合** — `mumu_boot_ready` `mumu_fresh_start_app` `mumu_batch_install` `mumu_monkey_test` `mumu_rename`
