Skip to content
Back to search

LyScript

An AI driven debugging assistant specially designed for x32/x64dbg, it helps to double the efficiency of reverse engineering, vulnerability mining, and malware analysis, making it your intelligent copilot.

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/lyshark--lyscript/badge.svg)](/listings/lyshark--lyscript)

HTML

<a href="/listings/lyshark--lyscript"><img src="/api/listings/lyshark--lyscript/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.

This automated control plugin is specifically designed for the x64dbg debugger, focusing on meeting the needs of the security industry. The plugin adopts a universal interface design, supporting direct calls through POSTMAN, HTTP, and MCP protocols. It can also seamlessly integrate with various large models, injecting AI capabilities into the debugging process to achieve advanced capabilities such as automated reverse engineering, intelligent breakpoint analysis, binary vulnerability detection, and malicious behavior tracing. This truly unleashes the potential of large models in the field of low-level debugging, providing efficient, intelligent, and automated new-generation technical support for security reverse engineering research.

Before using the plugin for subsequent operations, you need to download the corresponding version of the `x64dbg` debugger and place the compressed `LyScript` plugin file into the `plugins` directory of the debugger. During installation, select the appropriate plugin based on the bitness of the debugger being used.

Secondly, you need to install the corresponding version of the Python package. Open the terminal and enter `pip install x32dbg` to proceed with the installation. If you are using a 64-bit system, you should execute `pip install x64dbg` instead.

Microsoft Windows [12.0.0.0]
(c) 2025 Microsoft Corporation。

CMD > pip install x32dbg
Collecting x32dbg
  Downloading x32dbg-3.0.0-py3-none-any.whl.metadata (1.3 kB)
Downloading x32dbg-3.0.0-py3-none-any.whl (200 kB)
Installing collected packages: x32dbg
Successfully installed x32dbg-3.0.0

CMD > pip install x64dbg
Collecting x64dbg
  Downloading x64dbg-3.0.0-py3-none-any.whl.metadata (1.3 kB)
Downloading x64dbg-3.0.0-py3-none-any.whl (230 kB)
Installing collected packages: x64dbg
Successfully installed x64dbg-3.0.0

CMD > pip install fastmcp==3.4.7
Collecting fastmcp==3.4.7
  Downloading fastmcp-3.4.7-py3-none-any.whl.metadata (8.5 kB)

CMD > pip list
Package            Version
------------------ --------
x32dbg             3.0.0
x64dbg             3.0.0
fastmcp            3.4.7
fastmcp-slim       3.4.7

CMD > cd ./MCP Server
CMD > python main.py
[*] Successfully initialized MCP service(ID:lyscript_mcp_server_cherry,Backend:fastmcp)
Starting MCP server
Started server process
Waiting for application startup.
Application startup complete.
Uvicorn running on http://127.0.0.1:8001/mcp (Press CTRL+C to quit)

After everything is ready, run the `x32dbg` debugger and wait for the plugin to load successfully. Open the Python console, import the required modules, create a configuration object to specify the service address and port (default is 127.0.0.1:8000), and call the functional interface.

> python
Python 3.13.7 (tags/v3.13.7:bcee1c3, Aug 14 2025, 14:15:11) on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>
>>> from x32dbg import Config,BaseHttpClient
>>> from x32dbg import Debugger
>>> from x32dbg import Dissassembly
>>> from x32dbg import Module
>>> from x32dbg import Memory
>>> from x32dbg import Process
>>> from x32dbg import Gui
>>> import json
>>>
>>> config = Config(address="127.0.0.1", port=8000)
>>> config
<x32dbg.Config object at 0x00000222561F3620>
>>>
>>> is_available = config.is_server_available()
>>> is_available
True
>>>
>>> http_client = BaseHttpClient(config, debug=True)
[DEBUG] Parsed server URL: http://127.0.0.1:8000/
[DEBUG] BaseHttpClient instance initialized successfully
>>>
>>> debugger = Debugger(http_client)
[DEBUG][Debugger] Debugger instance initialized successfully
>>>
>>> eip = debugger.get_register("eip")
[DEBUG][Debugger] Converted single register input to list: ['eip']
[DEBUG][Debugger] Requesting register values: ['EIP']
[DEBUG] Serialized request body (size: 68 bytes)
[DEBUG] Sending POST request to: http://127.0.0.1:8000/
[DEBUG] Request headers:
{
  "Content-Type": "application/json; charset=utf-8",
  "Accept": "application/json",

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 · 150 lines

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

  1. # LYSCRIPT Dynamic Debugging and Analysis Component
  2. <br>
  3. <div align=center>
  4. <img width="20%" height="10%" alt="logo" src="https://github.com/user-attachments/assets/5b1af7e5-4216-4a6b-9c87-1bb0b876aa71" />
  5. </div>
  6. <br><br>
  7. <div align=center>
  8. [![Contributors](https://img.shields.io/github/contributors/lyshark/LyScript?color=2ea44f&logo=github)](https://github.com/lyshark/LyScript/graphs/contributors)
  9. [![Email Support](https://img.shields.io/badge/Contact-admin@lyshark.com-0099ff?logo=gmail)](mailto:admin@lyshark.com)
  10. [![Release Download](https://img.shields.io/github/downloads/lyshark/LyScript/total?color=orange&logo=windows)](https://github.com/lyshark/LyScript/releases/tag/LyScript)
  11. [![Python 3.x](https://img.shields.io/badge/Python-3.8%2B-blue?logo=python&logoColor=white)](https://github.com/lyshark/LyScript)
  12. [![Platform](https://img.shields.io/badge/Platform-Windows%20x64dbg-lightgrey?logo=windows)](https://github.com/lyshark/LyScript)
  13. [![LyScript Version](https://img.shields.io/github/v/tag/lyshark/LyScript?label=Version&sort=semver&color=success)](https://github.com/lyshark/LyScript/releases)
  14. [![GitHub Stars](https://img.shields.io/github/stars/lyshark/LyScript?style=social)](https://github.com/lyshark/LyScript/stargazers)
  15. [![GitHub Forks](https://img.shields.io/github/forks/lyshark/LyScript?style=social)](https://github.com/lyshark/LyScript/fork)
  16. [![License](https://img.shields.io/github/license/lyshark/LyScript)](https://github.com/lyshark/LyScript/blob/main/LICENSE)
  17. </div>
  18. LyScript is an automated debugging and reverse analysis plugin deeply customized for the x32/x64dbg debugger. It builds efficient debugging scripts with Python as its core, providing lightweight, programmable, and highly scalable debugging capabilities for security researchers, vulnerability developers, and malware analysts. Leveraging the powerful flexibility of the Python ecosystem and combining with the native capabilities of the debugger, the plugin achieves out-of-the-box functionality without relying on third-party dependencies. It also supports calling native scripts of x64dbg and custom combination functions, significantly enhancing work efficiency in scenarios such as vulnerability exploitation development, vulnerability mining, sample analysis, and reverse engineering.
  19. ## Quick Installation
  20. This automated control plugin is specifically designed for the x64dbg debugger, focusing on meeting the needs of the security industry. The plugin adopts a universal interface design, supporting direct calls through POSTMAN, HTTP, and MCP protocols. It can also seamlessly integrate with various large models, injecting AI capabilities into the debugging process to achieve advanced capabilities such as automated reverse engineering, intelligent breakpoint analysis, binary vulnerability detection, and malicious behavior tracing. This truly unleashes the potential of large models in the field of low-level debugging, providing efficient, intelligent, and automated new-generation technical support for security reverse engineering research.
  21. Before using the plugin for subsequent operations, you need to download the corresponding version of the `x64dbg` debugger and place the compressed `LyScript` plugin file into the `plugins` directory of the debugger. During installation, select the appropriate plugin based on the bitness of the debugger being used.
  22. Secondly, you need to install the corresponding version of the Python package. Open the terminal and enter `pip install x32dbg` to proceed with the installation. If you are using a 64-bit system, you should execute `pip install x64dbg` instead.
  23. ```bash
  24. Microsoft Windows [12.0.0.0]
  25. (c) 2025 Microsoft Corporation。
  26. CMD > pip install x32dbg
  27. Collecting x32dbg
  28. Downloading x32dbg-3.0.0-py3-none-any.whl.metadata (1.3 kB)
  29. Downloading x32dbg-3.0.0-py3-none-any.whl (200 kB)
  30. Installing collected packages: x32dbg
  31. Successfully installed x32dbg-3.0.0
  32. CMD > pip install x64dbg
  33. Collecting x64dbg
  34. Downloading x64dbg-3.0.0-py3-none-any.whl.metadata (1.3 kB)
  35. Downloading x64dbg-3.0.0-py3-none-any.whl (230 kB)
  36. Installing collected packages: x64dbg
  37. Successfully installed x64dbg-3.0.0
  38. CMD > pip install fastmcp==3.4.7
  39. Collecting fastmcp==3.4.7
  40. Downloading fastmcp-3.4.7-py3-none-any.whl.metadata (8.5 kB)
  41. CMD > pip list
  42. Package Version
  43. ------------------ --------
  44. x32dbg 3.0.0
  45. x64dbg 3.0.0
  46. fastmcp 3.4.7
  47. fastmcp-slim 3.4.7
  48. CMD > cd ./MCP Server
  49. CMD > python main.py
  50. [*] Successfully initialized MCP service(ID:lyscript_mcp_server_cherry,Backend:fastmcp)
  51. Starting MCP server
  52. Started server process
  53. Waiting for application startup.
  54. Application startup complete.
  55. Uvicorn running on http://127.0.0.1:8001/mcp (Press CTRL+C to quit)
  56. ```
  57. After everything is ready, run the `x32dbg` debugger and wait for the plugin to load successfully. Open the Python console, import the required modules, create a configuration object to specify the service address and port (default is 127.0.0.1:8000), and call the functional interface.
  58. ```python
  59. > python
  60. Python 3.13.7 (tags/v3.13.7:bcee1c3, Aug 14 2025, 14:15:11) on win32
  61. Type "help", "copyright", "credits" or "license" for more information.
  62. >>>
  63. >>> from x32dbg import Config,BaseHttpClient
  64. >>> from x32dbg import Debugger
  65. >>> from x32dbg import Dissassembly
  66. >>> from x32dbg import Module
  67. >>> from x32dbg import Memory
  68. >>> from x32dbg import Process
  69. >>> from x32dbg import Gui
  70. >>> import json
  71. >>>
  72. >>> config = Config(address="127.0.0.1", port=8000)
  73. >>> config
  74. <x32dbg.Config object at 0x00000222561F3620>
  75. >>>
  76. >>> is_available = config.is_server_available()
  77. >>> is_available
  78. True
  79. >>>
  80. >>> http_client = BaseHttpClient(config, debug=True)
  81. [DEBUG] Parsed server URL: http://127.0.0.1:8000/
  82. [DEBUG] BaseHttpClient instance initialized successfully
  83. >>>
  84. >>> debugger = Debugger(http_client)
  85. [DEBUG][Debugger] Debugger instance initialized successfully
  86. >>>
  87. >>> eip = debugger.get_register("eip")
  88. [DEBUG][Debugger] Converted single register input to list: ['eip']
  89. [DEBUG][Debugger] Requesting register values: ['EIP']
  90. [DEBUG] Serialized request body (size: 68 bytes)
  91. [DEBUG] Sending POST request to: http://127.0.0.1:8000/
  92. [DEBUG] Request headers:
  93. {
  94. "Content-Type": "application/json; charset=utf-8",
  95. "Accept": "application/json",
  96. "User-Agent": "Python-Robust-HTTP-Client/1.0"
  97. }
  98. [DEBUG] Request body:
  99. {
  100. "class": "Debugger",
  101. "interface": "GetRegister",
  102. "params": [
  103. "EIP"
  104. ]
  105. }
  106. [DEBUG] Received response: Status=200 (OK), Body:
  107. {
  108. "status": "success",
  109. "result": {
  110. "message": "Register value retrieved successfully",
  111. "register_name": "EIP",
  112. "register_index": 30,
  113. "value_decimal": 2008776905,
  114. "value_hex": "0x77BB80C9",
  115. "platform": "x86"
  116. },
  117. "timestamp": 12603843
  118. }
  119. [DEBUG] HTTP connection closed
  120. >>>
  121. >>> eip
  122. {
  123. 'message': 'Register value retrieved successfully',
  124. 'register_name': 'EIP',
  125. 'register_index': 30,
  126. 'value_decimal': 2008776905,
  127. 'value_hex': '0x77BB80C9',
  128. 'platform': 'x86'
  129. }
  130. ```
  131. Finally, a dictionary result containing register names, values (decimal/hexadecimal), and other information will be returned. Debug logs can track interaction details.

Ratings and comments

Sign in to rate this skill.

Sign in

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