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

Related MCP server: helix-pilot

Cài đặt

# 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

uv run mcp dev server.py

Claude Desktop Integration

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.