Frida Game Hacking MCP

🚀 Frida Game Hacking MCP

Frida Game Hacking MCP 是一個模型上下文協議（MCP）服務器，藉助 Frida 為遊戲破解提供 類似 Cheat Engine 的功能。它能讓 AI 助手和自動化工具進行內存掃描、數值修改、模式匹配、函數掛鉤和代碼注入。

✨ 主要特性

內存操作（類似 Cheat Engine）

• 數值掃描：按類型（int8 - 64、float、double、string）在內存中查找數值。
• 掃描細化：使用 scan_next、scan_changed、scan_unchanged 縮小掃描結果範圍。
• 模式掃描：支持通配符（??）的字節數組（AoB）掃描。
• 內存讀寫：能感知類型地讀取和修改內存。

函數掛鉤與代碼注入

• 攔截函數：使用 onEnter/onLeave JavaScript 回調進行掛鉤。
• 替換函數：使函數返回自定義值。
• 模塊掛鉤：通過 module!function 名稱進行掛鉤。
• 符號解析：將導出解析為地址。

進程管理

• 進程枚舉：列出並過濾正在運行的進程。
• 附加/分離：連接到正在運行的進程或從當前進程分離。
• 啟動與恢復：以掛起狀態啟動進程，便於早期掛鉤。

調試

• 斷點：通過掛鉤設置軟件斷點。
• 寄存器訪問：在斷點處讀取 CPU 寄存器。
• 模塊分析：列出模塊、導出和導入。

窗口交互（Windows）

• 截圖捕獲：截取遊戲窗口的屏幕截圖。
• 鍵盤輸入：向遊戲窗口發送按鍵。
• 窗口管理：列出、聚焦和與窗口交互。

📦 安裝指南

# 即將支持從 PyPI 安裝
pip install frida-game-hacking-mcp

# 或者從源代碼安裝
git clone https://github.com/0xhackerfren/frida-game-hacking-mcp.git
cd frida-game-hacking-mcp
pip install -e .

要求

• Python 3.10 及以上版本
• Frida 16.0 及以上版本
• pywin32、pillow（Windows 系統，用於截圖功能）

pip install frida frida-tools mcp pillow
# 在 Windows 系統上，還需安裝：
pip install pywin32

🚀 快速開始

運行 MCP 服務器

# 直接運行
python -m frida_game_hacking_mcp

# 或者使用入口點
frida-game-hacking-mcp

與 Claude Desktop 進行配置

在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "frida-game-hacking": {
      "command": "python",
      "args": ["-m", "frida_game_hacking_mcp"]
    }
  }
}

與其他 MCP 客戶端進行配置

服務器默認使用標準輸入輸出傳輸。使用以下方式連接：

• 命令：python -m frida_game_hacking_mcp
• 傳輸方式：標準輸入輸出

💻 使用示例

基礎用法

Cheat Engine 工作流程：查找並修改生命值

1. 列出進程並找到你的遊戲
   > list_processes("game")
   
2. 附加到遊戲進程
   > attach("game.exe")
   
3. 初始掃描當前生命值（例如，100）
   > scan_value(100, "int32")
   找到：58,869 個地址
   
4. 在遊戲中受到傷害（生命值變為 95）
   > scan_next(95)
   縮小到：1,419 個地址
   
5. 重複操作直到找到地址
   > scan_next(90)
   縮小到：3 個地址
   
6. 獲取結果並修改
   > get_scan_results()
   > write_memory("0x12345678", "E7030000")  # 小端序表示的 999

字節數組模式掃描

# 查找代碼模式（適用於遊戲更新）
> attach("game.exe")
> scan_pattern("89 47 44 ?? ?? 5B 7A", "r-x")
找到：2 個匹配項

# ?? = 通配字節
# "r-x" = 可執行內存區域

高級用法

函數掛鉤

# 掛鉤一個函數並記錄調用
> hook_function("0x401234",
    on_enter="console.log('Args:', args[0], args[1]);",
    on_leave="console.log('Return:', retval);")

# 使一個函數始終返回成功
> replace_function("0x401234", 1)

# 通過模塊和函數名進行掛鉤
> intercept_module_function("game.dll", "CheckLicense",
    on_leave="retval.replace(1);")

早期掛鉤（掛起啟動）

# 以掛起狀態啟動進程
> spawn("C:/Games/game.exe")

# 在代碼運行前設置掛鉤
> hook_function("0x401234", on_enter="...")

# 恢復執行
> resume()

📚 詳細文檔

可用工具（共 42 個）

進程管理（6 個）

內存操作（10 個）

模塊信息（5 個）

函數掛鉤（6 個）

調試（4 個）

腳本管理（3 個）

窗口交互（5 個，僅適用於 Windows）

標準 MCP（3 個）

值類型

掃描區域

平臺支持

• Windows：原生支持
• Linux：原生支持
• macOS：原生支持
• Android：通過 frida-server 支持
• iOS：通過 frida-server（越獄設備）支持

使用場景

• 遊戲破解：內存編輯、數值修改、輔助工具開發
• 安全研究：漏洞分析、漏洞利用開發
• 逆向工程：運行時分析、API 掛鉤
• 軟件測試：故障注入、行為修改
• 惡意軟件分析：沙箱環境中的動態分析

🔧 技術細節

安全注意事項

本工具僅用於以下目的：

• 教育用途
• 對自己擁有或獲得測試許可的軟件進行安全研究
• 單機/離線遊戲的模組開發

請勿用於以下行為：

• 在線多人遊戲作弊
• 非法繞過軟件保護
• 任何惡意目的

貢獻

歡迎貢獻代碼！請按以下步驟操作：

1. 分叉倉庫
2. 創建功能分支
3. 提交拉取請求

📄 許可證

本項目採用 MIT 許可證，請參閱 LICENSE 文件。

致謝

• 基於 Ole Andre Vadla Ravnas 開發的 Frida 構建
• MCP 協議由 Anthropic 提供
• 受 Dark Byte 開發的 Cheat Engine 啟發

鏈接

• Frida 文檔
• MCP 規範
• 報告問題

專為 AI 輔助遊戲破解和安全研究而構建。