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
# 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êncapture_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ìnhget_window_info- Lấy thông tin cửa sổ gamefocus_game_window- Focus vào cửa sổ gamelist_all_windows- Liệt kê tất cả cửa sổget_last_screenshot- Lấy đường dẫn screenshot cuốilist_screenshots- Liệt kê tất cả screenshotsclear_screenshots- Xóa tất cả screenshots
Ví dụ sử dụng
AI có thể sử dụng các tools này để:
- Tìm cửa sổ game:
find_game_window("Genshin Impact") - Chụp màn hình:
capture_game_screen()→ Trả về đường dẫn file ảnh - AI đọc ảnh từ đường dẫn để phân tích
- Click vào nút:
click_at_position(x=500, y=300, description="Gacha button") - Đợ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.