Skip to content
Back to search

frida-game-hacking-mcp

A MCP implementation of Frida that seeks to emulate Cheat Engine functionally to allow for seamless Game Hacking by AI agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/0xhackerfren--frida-game-hacking-mcp/badge.svg)](/listings/0xhackerfren--frida-game-hacking-mcp)

HTML

<a href="/listings/0xhackerfren--frida-game-hacking-mcp"><img src="/api/listings/0xhackerfren--frida-game-hacking-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Install from PyPI (coming soon)
pip install frida-game-hacking-mcp

# Or install from source
git clone https://github.com/0xhackerfren/frida-game-hacking-mcp.git
cd frida-game-hacking-mcp
pip install -e .

Requirements

- Python 3.10+ - Frida 16.0+ - pywin32, pillow (Windows, for screenshot features)

pip install frida frida-tools mcp pillow
# On Windows, also install:
pip install pywin32

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 318 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Frida Game Hacking MCP
  2. A Model Context Protocol (MCP) server that provides **Cheat Engine-like capabilities** for game hacking through [Frida](https://frida.re/). Enables AI assistants and automation tools to perform memory scanning, value modification, pattern matching, function hooking, and code injection.
  3. ![MCP](https://img.shields.io/badge/MCP-Compatible-blue)
  4. ![Python](https://img.shields.io/badge/Python-3.10+-green)
  5. ![Frida](https://img.shields.io/badge/Frida-16.0+-orange)
  6. ![License](https://img.shields.io/badge/License-MIT-yellow)
  7. ## Features
  8. ### Memory Operations (Cheat Engine Style)
  9. - **Value Scanning**: Find values in memory by type (int8-64, float, double, string)
  10. - **Scan Refinement**: Narrow results with `scan_next`, `scan_changed`, `scan_unchanged`
  11. - **Pattern Scanning**: Array of Bytes (AoB) with wildcard support (`??`)
  12. - **Memory Read/Write**: Read and modify memory with type awareness
  13. ### Function Hooking & Code Injection
  14. - **Intercept Functions**: Hook with `onEnter`/`onLeave` JavaScript callbacks
  15. - **Replace Functions**: Make functions return custom values
  16. - **Module Hooking**: Hook by `module!function` name
  17. - **Symbol Resolution**: Resolve exports to addresses
  18. ### Process Management
  19. - **Process Enumeration**: List and filter running processes
  20. - **Attach/Detach**: Connect to running processes
  21. - **Spawn & Resume**: Start processes suspended for early hooking
  22. ### Debugging
  23. - **Breakpoints**: Software breakpoints via hooks
  24. - **Register Access**: Read CPU registers at breakpoints
  25. - **Module Analysis**: List modules, exports, imports
  26. ### Window Interaction (Windows)
  27. - **Screenshot Capture**: Take screenshots of game windows
  28. - **Keyboard Input**: Send keystrokes to game windows
  29. - **Window Management**: List, focus, and interact with windows
  30. ## Installation
  31. ```bash
  32. # Install from PyPI (coming soon)
  33. pip install frida-game-hacking-mcp
  34. # Or install from source
  35. git clone https://github.com/0xhackerfren/frida-game-hacking-mcp.git
  36. cd frida-game-hacking-mcp
  37. pip install -e .
  38. ```
  39. ### Requirements
  40. - Python 3.10+
  41. - Frida 16.0+
  42. - pywin32, pillow (Windows, for screenshot features)
  43. ```bash
  44. pip install frida frida-tools mcp pillow
  45. # On Windows, also install:
  46. pip install pywin32
  47. ```
  48. ## Quick Start
  49. ### Run the MCP Server
  50. ```bash
  51. # Run directly
  52. python -m frida_game_hacking_mcp
  53. # Or use the entry point
  54. frida-game-hacking-mcp
  55. ```
  56. ### Configure with Claude Desktop
  57. Add to your `claude_desktop_config.json`:
  58. ```json
  59. {
  60. "mcpServers": {
  61. "frida-game-hacking": {
  62. "command": "python",
  63. "args": ["-m", "frida_game_hacking_mcp"]
  64. }
  65. }
  66. }
  67. ```
  68. ### Configure with Other MCP Clients
  69. The server uses stdio transport by default. Connect using:
  70. - Command: `python -m frida_game_hacking_mcp`
  71. - Transport: stdio
  72. ## Usage Examples
  73. ### Cheat Engine Workflow: Find and Modify Health
  74. ```
  75. 1. List processes and find your game
  76. > list_processes("game")
  77. 2. Attach to the game
  78. > attach("game.exe")
  79. 3. Initial scan for current health value (e.g., 100)
  80. > scan_value(100, "int32")
  81. Found: 58,869 addresses
  82. 4. Take damage in game (health now 95)
  83. > scan_next(95)
  84. Narrowed to: 1,419 addresses
  85. 5. Repeat until you find the address
  86. > scan_next(90)
  87. Narrowed to: 3 addresses
  88. 6. Get results and modify
  89. > get_scan_results()
  90. > write_memory("0x12345678", "E7030000") # 999 in little-endian
  91. ```
  92. ### Array of Bytes Pattern Scanning
  93. ```
  94. # Find code pattern (works across game updates)
  95. > attach("game.exe")
  96. > scan_pattern("89 47 44 ?? ?? 5B 7A", "r-x")
  97. Found: 2 matches
  98. # ?? = wildcard bytes
  99. # "r-x" = executable memory regions
  100. ```
  101. ### Function Hooking
  102. ```
  103. # Hook a function and log calls
  104. > hook_function("0x401234",
  105. on_enter="console.log('Args:', args[0], args[1]);",
  106. on_leave="console.log('Return:', retval);")
  107. # Make a function always return success
  108. > replace_function("0x401234", 1)
  109. # Hook by module and function name
  110. > intercept_module_function("game.dll", "CheckLicense",
  111. on_leave="retval.replace(1);")
  112. ```
  113. ### Early Hooking (Spawn Suspended)
  114. ```
  115. # Start process suspended
  116. > spawn("C:/Games/game.exe")
  117. # Set up hooks before code runs
  118. > hook_function("0x401234", on_enter="...")
  119. # Resume execution
  120. > resume()
  121. ```
  122. ## Available Tools (42 Total)
  123. ### Process Management (6)
  124. | Tool | Description |
  125. |------|-------------|
  126. | `list_processes` | Enumerate running processes |
  127. | `attach` | Attach to process by name or PID |
  128. | `detach` | Detach from current process |
  129. | `spawn` | Start process suspended |
  130. | `resume` | Resume spawned process |
  131. | `get_session_info` | Get current session status |
  132. ### Memory Operations (10)
  133. | Tool | Description |
  134. |------|-------------|
  135. | `read_memory` | Read bytes at address |
  136. | `write_memory` | Write bytes/values to address |
  137. | `scan_value` | Initial scan for exact value |
  138. | `scan_next` | Narrow scan with new value |
  139. | `scan_changed` | Find changed values |
  140. | `scan_unchanged` | Find unchanged values |
  141. | `scan_pattern` | AoB pattern scan with wildcards |
  142. | `get_scan_results` | Get current scan results |
  143. | `clear_scan` | Reset scan state |
  144. | `list_memory_regions` | List memory regions |
  145. ### Module Information (5)
  146. | Tool | Description |
  147. |------|-------------|
  148. | `list_modules` | List loaded modules/DLLs |
  149. | `get_module_info` | Get module details |
  150. | `get_module_exports` | List module exports |
  151. | `get_module_imports` | List module imports |
  152. | `resolve_symbol` | Resolve symbol to address |
  153. ### Function Hooking (6)
  154. | Tool | Description |
  155. |------|-------------|
  156. | `hook_function` | Hook with callbacks |
  157. | `unhook_function` | Remove hook |
  158. | `replace_function` | Replace function return |
  159. | `hook_native_function` | Hook with calling convention |
  160. | `list_hooks` | List active hooks |
  161. | `intercept_module_function` | Hook by module!function |
  162. ### Debugging (4)
  163. | Tool | Description |
  164. |------|-------------|
  165. | `set_breakpoint` | Set software breakpoint |
  166. | `remove_breakpoint` | Remove breakpoint |
  167. | `list_breakpoints` | List breakpoints |
  168. | `read_registers` | Read CPU registers |
  169. ### Script Management (3)
  170. | Tool | Description |
  171. |------|-------------|
  172. | `load_script` | Load custom Frida JS |
  173. | `unload_script` | Unload script |
  174. | `call_rpc` | Call script RPC export |
  175. ### Window Interaction (5) - Windows Only
  176. | Tool | Description |
  177. |------|-------------|
  178. | `list_windows` | Enumerate visible windows |
  179. | `screenshot_window` | Capture window to PNG/base64 |
  180. | `screenshot_screen` | Capture screen or region |
  181. | `send_key_to_window` | Send keystrokes to window |
  182. | `focus_window` | Bring window to foreground |
  183. ### Standard MCP (3)
  184. | Tool | Description |
  185. |------|-------------|
  186. | `list_capabilities` | List all tools |
  187. | `get_documentation` | Get help and examples |
  188. | `check_installation` | Verify Frida installed |
  189. ## Value Types
  190. | Type | Size | Description |
  191. |------|------|-------------|
  192. | `int8` | 1 byte | Signed byte |
  193. | `uint8` | 1 byte | Unsigned byte |
  194. | `int16` | 2 bytes | Signed short |
  195. | `uint16` | 2 bytes | Unsigned short |
  196. | `int32` | 4 bytes | Signed int (most common) |
  197. | `uint32` | 4 bytes | Unsigned int |
  198. | `int64` | 8 bytes | Signed long |
  199. | `uint64` | 8 bytes | Unsigned long |
  200. | `float` | 4 bytes | Single precision |
  201. | `double` | 8 bytes | Double precision |
  202. | `string` | Variable | Null-terminated string |
  203. ## Scan Regions
  204. | Region | Description |
  205. |--------|-------------|
  206. | `rw-` | Read-write data (heap, stack, globals) - default for value scans |
  207. | `r-x` | Executable code - default for pattern scans |
  208. | `rwx` | Read-write-execute (rare, often exploitable) |
  209. | `r--` | Read-only data |
  210. ## Platform Support
  211. - **Windows**: Native support
  212. - **Linux**: Native support
  213. - **macOS**: Native support
  214. - **Android**: Via frida-server
  215. - **iOS**: Via frida-server (jailbroken)
  216. ## Use Cases
  217. - **Game Hacking**: Memory editing, value modification, trainer development
  218. - **Security Research**: Vulnerability analysis, exploit development
  219. - **Reverse Engineering**: Runtime analysis, API hooking
  220. - **Software Testing**: Fault injection, behavior modification
  221. - **Malware Analysis**: Dynamic analysis in sandboxed environments
  222. ## Security Notice
  223. This tool is intended for:
  224. - Educational purposes
  225. - Security research on software you own or have permission to test
  226. - Game modding in single-player/offline contexts
  227. **Do not use for**:
  228. - Cheating in online multiplayer games
  229. - Circumventing software protections illegally
  230. - Any malicious purposes
  231. ## Contributing
  232. Contributions welcome! Please:
  233. 1. Fork the repository
  234. 2. Create a feature branch
  235. 3. Submit a pull request
  236. ## License
  237. MIT License - see [LICENSE](LICENSE)
  238. ## Credits
  239. - Built on [Frida](https://frida.re/) by Ole Andre Vadla Ravnas
  240. - MCP protocol by [Anthropic](https://github.com/anthropics/anthropic-cookbook/tree/main/misc/model_context_protocol)
  241. - Inspired by [Cheat Engine](https://www.cheatengine.org/) by Dark Byte
  242. ## Links
  243. - [Frida Documentation](https://frida.re/docs/)
  244. - [MCP Specification](https://spec.modelcontextprotocol.io/)
  245. - [Report Issues](https://github.com/0xhackerfren/frida-game-hacking-mcp/issues)
  246. ---
  247. *Built for AI-assisted game hacking and security research.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.