# MuMu Player Control for Codex, Antigravity, and Claude Code

This ZIP bundles the local MuMu MCP server, its agent skill, and an installer. The server runs on the same computer as MuMu Player and connects only to the configured ADB serial.

## Install

1. Extract the ZIP.
2. In the extracted folder, run `py install.py` on Windows or `python3 install.py` on macOS/Linux.
3. Choose the MuMu ADB device when prompted. If ADB is not on `PATH`, provide its executable path.
4. Restart the selected agent apps.

The installer configures all three agents by default. To select specific agents or skip prompts when ADB is already known:

```powershell
py install.py --agents codex antigravity claude-code --adb-path "C:\path\to\adb.exe" --serial 127.0.0.1:16384
```

It creates an isolated Python environment, installs the MCP dependency, installs the skill globally, and updates each selected agent's user MCP configuration. Existing configuration files are backed up before changes; unrelated entries are preserved. If a same-named skill has local edits, the installer keeps a backup before updating it.

Requirements: Python 3.11+, MuMu Player's ADB executable, and network access for the first dependency installation.

## What is installed

- Codex: user MCP configuration and `~/.agents/skills/mumu-player-control/`.
- Antigravity IDE and CLI: shared MCP configuration plus each surface's global skill directory.
- Claude Code: user-scope MCP configuration and `~/.claude/skills/mumu-player-control/`.

The skill explains how to inspect the screen, use bounded controls, and collect game logs. The MCP server does not provide arbitrary shell access and does not edit saves or app data.

## Troubleshooting

- Run the installer again with `--serial` if more than one ADB device is connected.
- Check that the serial is listed by `adb devices -l` and has state `device`.
- After installation, restart the agent and check its MCP server status (`/mcp` in Claude Code; MCP server settings in Codex or Antigravity).

Official setup references: [Codex MCP](https://learn.chatgpt.com/docs/extend/mcp), [Antigravity MCP](https://antigravity.google/docs/mcp), and [Claude Code MCP](https://code.claude.com/docs/en/mcp).