feat: add delay tool and comprehensive test suite

- Add delay tool to misc module for time-based operations
- Set up pytest configuration with coverage reporting
- Create comprehensive test suite with fixtures for device mocking
- Add GitHub Actions workflow for automated testing
- Configure Claude permissions for test execution
- Include test dependency group in pyproject.toml

Author: tanbro

.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run pytest:*)",
+      "Bash(uv run python:*)",
+      "Bash(uv run test:*)"
+    ]
+  }
+}

.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: uv sync --group test
+
+    - name: Run tests with coverage
+      run: uv run pytest --cov=src/u2mcp --cov-report=term-missing --cov-report=xml
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false

pyproject.toml

@@ -43,3 +43,4 @@ changelog = "https://github.com/tanbro/uiautomator2-mcp-server/blob/main/CHANGEL
 
 [dependency-groups]
 dev = ["mypy"]
+test = ["pytest", "pytest-asyncio", "pytest-cov", "pytest-mock"]

pytest.ini

@@ -0,0 +1,19 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+addopts =
+    -v
+    --tb=short
+    --strict-markers
+    --disable-warnings
+    --cov=src/u2mcp
+    --cov-report=term-missing
+    --cov-report=html
+    --asyncio-mode=auto
+markers =
+    unit: Unit tests (fast, no external dependencies)
+    integration: Integration tests (may require external services)
+    slow: Slow running tests
+    device: Tests that require actual Android device

src/u2mcp/tools/__init__.py

@@ -1,3 +1,4 @@
 from .action import *
 from .app import *
 from .device import *
+from .misc import *

src/u2mcp/tools/misc.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+import asyncio
+
+from ..mcp import mcp
+
+
+@mcp.tool("delay")
+async def delay(duration: float):
+    """Delay for a specific amount of time
+
+    Args:
+        duration (float): Duration in seconds
+    """
+    await asyncio.sleep(duration)

tests/__init__.py

@@ -0,0 +1,3 @@
+"""
+Test package for uiautomator2-mcp-server.
+"""

tests/conftest.py

@@ -0,0 +1,104 @@
+"""
+Pytest configuration and shared fixtures for uiautomator2-mcp-server tests.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from typing import AsyncGenerator
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+
+@pytest.fixture
+def mock_u2_device() -> MagicMock:
+    """Create a mocked uiautomator2 device."""
+    mock_device = MagicMock()
+    # Setup common device methods
+    mock_device.info = {"productName": "test_device", "version": "13", "serial": "emulator-5554"}
+    mock_device.device_info = {"serial": "emulator-5554", "model": "test_device"}
+    mock_device.window_size = MagicMock(return_value=(1080, 2400))
+    mock_device.screenshot = MagicMock(return_value=MagicMock())
+    mock_device.dump_hierarchy = MagicMock(return_value="<hierarchy/>")
+    mock_device.click = AsyncMock()
+    mock_device.long_click = AsyncMock()
+    mock_device.double_click = AsyncMock()
+    mock_device.swipe = AsyncMock()
+    mock_device.swipe_points = AsyncMock()
+    mock_device.drag = AsyncMock()
+    mock_device.press = AsyncMock()
+    mock_device.send_keys = AsyncMock()
+    mock_device.clear_text = AsyncMock()
+    mock_device.screen_on = AsyncMock()
+    mock_device.screen_off = AsyncMock()
+
+    # App management methods
+    mock_device.app_start = AsyncMock()
+    mock_device.app_wait = AsyncMock()
+    mock_device.app_stop = AsyncMock()
+    mock_device.app_stop_all = AsyncMock()
+    mock_device.app_info = MagicMock(return_value={"packageName": "com.example.app", "versionName": "1.0", "versionCode": 1})
+    mock_device.app_current = MagicMock(return_value={"package": "com.example.app"})
+    mock_device.app_list = MagicMock(return_value=["com.example.app1", "com.example.app2"])
+    mock_device.app_list_running = MagicMock(return_value=["com.example.app1"])
+    mock_device.app_install = AsyncMock()
+    mock_device.app_uninstall = AsyncMock()
+    mock_device.app_uninstall_all = AsyncMock()
+    mock_device.app_clear = AsyncMock()
+    mock_device.app_auto_grant_permissions = AsyncMock()
+
+    return mock_device
+
+
+@pytest.fixture
+def mock_adb() -> MagicMock:
+    """Create a mocked adbutils.adb object."""
+    mock_adb = MagicMock()
+    mock_device = MagicMock()
+    mock_device.serial = "emulator-5554"
+    mock_device.prop = MagicMock(return_value="test_value")
+    mock_adb.device = MagicMock(return_value=mock_device)
+    mock_adb.device_list = MagicMock(return_value=[mock_device])
+    return mock_adb
+
+
+@pytest.fixture
+def mock_u2_module(mock_u2_device: MagicMock) -> MagicMock:
+    """Create a mocked uiautomator2 module."""
+    mock_u2 = MagicMock()
+    mock_u2.connect = MagicMock(return_value=mock_u2_device)
+    mock_u2.Device = MagicMock(return_value=mock_u2_device)
+    return mock_u2
+
+
+@pytest.fixture
+def event_loop():
+    """Create an event loop for async tests."""
+    loop = asyncio.new_event_loop()
+    yield loop
+    loop.close()
+
+
+@pytest.fixture(autouse=True)
+def mock_device_dependencies(  # type: ignore
+    mock_u2_device: MagicMock,
+    mock_u2_module: MagicMock,
+    mock_adb: MagicMock,
+) -> AsyncGenerator[None, None]:  # type: ignore
+    """
+    Automatically mock uiautomator2 and adbutils dependencies for all tests.
+
+    This ensures tests don't require actual Android devices or ADB connections.
+    """
+    with patch("u2mcp.tools.device.u2", mock_u2_module), patch("u2mcp.tools.device.adb", mock_adb):
+        yield  # type: ignore
+
+
+@pytest.fixture
+def mock_context() -> MagicMock:
+    """Create a mocked FastMCP context."""
+    mock_context = MagicMock()
+    mock_context.session = MagicMock()
+    mock_context.session.id = "test-session-id"
+    return mock_context