GachaMCP

# GachaMCP - Python Game Automation MCP Server MCP Server giúp AI tương tác với Gacha Game thông qua screenshot và click automation! ## Tính năng - 🖼️ **Chụp màn hình game** - Capture cửa sổ game để AI phân tích - 🖱️ **Click automation** - Click theo tọa độ trên cửa sổ game - 🪟 **Window management** - Tìm và quản lý cửa sổ game - ⏱️ **Smart delays** - Đợi và chụp lại sau mỗi hành động - 🎮 **Game state tracking** - Theo dõi trạng thái game ## Cài đặt ```bash # Tạo virtual environment python -m venv venv source venv/bin/activate # Linux/Mac # hoặc venv\Scripts\activate # Windows # Cài đặt dependencies pip install -r requirements.txt ``` ## Sử dụng ### Development Mode ```bash uv run mcp dev server.py ``` ### Claude Desktop Integration ```bash uv run mcp install server.py --name "GachaMCP" ``` ## MCP Tools - `find_game_window` - Tìm cửa sổ game theo tên - `capture_game_screen` - Chụp màn hình cửa sổ game (lưu file) - `click_at_position` - Click tại tọa độ cụ thể - `wait_and_capture` - Đợi và chụp lại màn hình - `get_window_info` - Lấy thông tin cửa sổ game - `focus_game_window` - Focus vào cửa sổ game - `list_all_windows` - Liệt kê tất cả cửa sổ - `get_last_screenshot` - Lấy đường dẫn screenshot cuối - `list_screenshots` - Liệt kê tất cả screenshots - `clear_screenshots` - Xóa tất cả screenshots ## Ví dụ sử dụng AI có thể sử dụng các tools này để: 1. Tìm cửa sổ game: `find_game_window("Genshin Impact")` 2. Chụp màn hình: `capture_game_screen()` → Trả về đường dẫn file ảnh 3. AI đọc ảnh từ đường dẫn để phân tích 4. Click vào nút: `click_at_position(x=500, y=300, description="Gacha button")` 5. Đợi và chụp lại: `wait_and_capture(delay=2.0)` → Ảnh mới **Lưu ý:** Screenshots được lưu trong thư mục `screenshots/` với tên file có timestamp.