# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.1.0] - 2024-10-05

### Added
- Initial release of Android MCP Server
- **Device Management Tools**
  - `get_devices`: List connected Android devices with status
  - `select_device`: Select device by ID or auto-select first available
  - `get_device_info`: Retrieve device specifications and health status
- **UI Automation Tools**
  - `get_ui_layout`: Extract complete UI hierarchy from devices
  - `list_screen_elements`: Get LLM-friendly list of interactive elements
  - `find_elements`: Search UI elements by text, resource ID, content description, or class
  - `tap_screen`: Tap at specific screen coordinates
  - `tap_element`: Find and tap UI elements with flexible matching
  - `swipe_screen`: Perform swipe gestures between coordinates
  - `swipe_direction`: Swipe in cardinal directions (up/down/left/right)
  - `input_text`: Send text to focused input fields
  - `press_key`: Send key events (BACK, HOME, ENTER, etc.)
- **Media Capture Tools**
  - `take_screenshot`: Capture device screenshots with customizable options
  - `start_screen_recording`: Record screen to MP4 with quality controls
  - `stop_screen_recording`: Stop recording and retrieve video file
  - `list_active_recordings`: View all active recording sessions
- **Log Monitoring Tools**
  - `get_logcat`: Fetch filtered logcat entries
  - `start_log_monitoring`: Begin continuous log monitoring with filtering
  - `stop_log_monitoring`: Stop monitoring and retrieve statistics
  - `list_active_monitors`: View all active log monitoring sessions
- **Architecture & Quality**
  - Modular architecture with clean separation of concerns
  - Comprehensive test suite with 80%+ code coverage
  - Type hints and Pydantic validation throughout
  - Timeout handling and error recovery
  - Input validation and security measures
- **Documentation**
  - Complete README with examples and troubleshooting
  - Inline documentation for all tools
  - Type annotations for IDE support

### Technical Details
- Python 3.11+ support
- AsyncIO-based for efficient concurrent operations
- FastMCP server implementation
- ADB (Android Debug Bridge) integration
- Pydantic models for parameter validation
- Comprehensive error handling and logging

[0.1.0]: https://github.com/jaye773/android-mcp-server/releases/tag/v0.1.0
