Frida Game Hacking MCP

Instructions

Clear current scan results and reset scan state.

Returns:
    Confirmation message.

Implementation Reference

• src/frida_game_hacking_mcp/server.py:1242-1252 (handler)

  The handler function for the 'clear_scan' MCP tool. It resets the global FridaSession's scan_state by assigning a new empty ScanState instance and returns a success message.

  def clear_scan() -> Dict[str, Any]:
      """
      Clear current scan results and reset scan state.
      
      Returns:
          Confirmation message.
      """
      global _session
      _session.scan_state = ScanState()
      return {"success": True, "message": "Scan state cleared."}

• src/frida_game_hacking_mcp/server.py:66-72 (helper)

  Dataclass defining the ScanState used by the scanning tools, including clear_scan. It holds value_type, results list, last_values dict, and scan_active flag.

  class ScanState:
      """Tracks memory scan state for Cheat Engine-style scanning."""
      value_type: str = ""
      results: List[int] = field(default_factory=list)
      last_values: Dict[int, Any] = field(default_factory=dict)
      scan_active: bool = False

• src/frida_game_hacking_mcp/server.py:195-223 (registration)

  The list_capabilities tool lists 'clear_scan' under memory_operations category, confirming its registration in the MCP server.

          "memory_operations": [
              "read_memory", "write_memory", "scan_value", "scan_next",
              "scan_changed", "scan_unchanged", "scan_pattern",
              "get_scan_results", "clear_scan", "list_memory_regions"
          ],
          "module_information": [
              "list_modules", "get_module_info", "get_module_exports",
              "get_module_imports", "resolve_symbol"
          ],
          "function_hooking": [
              "hook_function", "unhook_function", "replace_function",
              "hook_native_function", "list_hooks", "intercept_module_function"
          ],
          "debugging": [
              "set_breakpoint", "remove_breakpoint", "list_breakpoints", "read_registers"
          ],
          "script_management": [
              "load_script", "unload_script", "call_rpc"
          ],
          "window_interaction": [
              "list_windows", "screenshot_window", "screenshot_screen",
              "send_key_to_window", "focus_window"
          ],
          "standard": [
              "list_capabilities", "get_documentation", "check_installation"
          ]
      },
      "total_tools": 42
  }