press_home
Press the home button on an Android device to return to the home screen or exit apps during development, testing, or debugging workflows.
Instructions
Press the home button
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_serial | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/adb_mcp_server/server.py:547-550 (handler)The main handler function for the 'press_home' tool. Decorated with @mcp.tool() for registration in FastMCP. Implements pressing the Android HOME key by calling the press_key helper function.
@mcp.tool() def press_home(device_serial: str | None = None) -> str: """Press the home button""" return press_key("HOME", device_serial) - src/adb_mcp_server/server.py:516-539 (helper)Supporting helper function 'press_key' that maps string keycodes like 'HOME' to numeric codes (e.g., '3') and executes the ADB command to simulate key press. Directly called by press_home.
@mcp.tool() def press_key(keycode: str, device_serial: str | None = None) -> str: """ Press a key by keycode name or number. Common keycodes: - HOME (3), BACK (4), CALL (5), ENDCALL (6) - VOLUME_UP (24), VOLUME_DOWN (25), POWER (26) - CAMERA (27), ENTER (66), DEL/BACKSPACE (67) - TAB (61), SPACE (62), MENU (82) - SEARCH (84), MEDIA_PLAY_PAUSE (85) - PAGE_UP (92), PAGE_DOWN (93) """ # Handle common names key_map = { 'HOME': '3', 'BACK': '4', 'ENTER': '66', 'DELETE': '67', 'DEL': '67', 'TAB': '61', 'SPACE': '62', 'MENU': '82', 'SEARCH': '84', 'VOLUME_UP': '24', 'VOLUME_DOWN': '25', 'POWER': '26', 'PAGE_UP': '92', 'PAGE_DOWN': '93', 'ESCAPE': '111', 'ESC': '111' } key = key_map.get(keycode.upper(), keycode) return run_adb(["shell", "input", "keyevent", key], device_serial)