LyScript MCP server
Commit 2. Okt. 2026Ermöglicht es einem AI-Client, den x32/x64dbg Debugger zu steuern, um Register, Memory, Module und Disassembly während des Reverse Engineering zu inspizieren.
Auch bekannt als lyshark/LyScript
- Stars
- 82
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 2. Okt. 2026
- Lizenz
- GPL-3.0
Was ist LyScript MCP?
LyScript ist ein MCP server. Ermöglicht es einem AI-Client, den x32/x64dbg Debugger zu steuern, um Register, Memory, Module und Disassembly während des Reverse Engineering zu inspizieren.
Zusammenfassung generiert aus dem README des Projekts
Über LyScript MCP server
Security Researcher und Malware-Analysten können LyScript nutzen, um x32/x64dbg Debugger direkt über einen AI-Client zu steuern. Durch die Integration in den Debugger via MCP Protokoll ermöglicht der Server einer KI, Low-Level-Aufgaben wie das Inspizieren von Registern, das Analysieren von Memory, das Untersuchen von Modulen und das Anzeigen von Disassembly durchzuführen. Dieses Setup ermöglicht automatisiertes Reverse Engineering und intelligente Breakpoint-Analysen, indem Large Language Models mit aktiven Debugging-Sessions verknüpft werden.
Um dieses Tool zu nutzen, musst du die LyScript Plugin-Datei in das plugins Verzeichnis deiner x32dbg oder x64dbg Installation unter Windows legen. Die Umgebung erfordert die Installation des x32dbg oder x64dbg Python Packages via pip, abhängig von der Bit-Architektur deines Systems. Sobald der MCP Service läuft, kommuniziert der AI-Client über eine lokale Service-Adresse und einen Port mit dem Debugger, wobei typischerweise ein Configuration-Objekt zur Verwaltung der Verbindung genutzt wird.
Was du damit machen kannst
- 1Automatisierte Register-InspektionLass die KI spezifische Registerwerte wie EIP abrufen, um den aktuellen Ausführungszustand zu verstehen.
- 2Tracing von bösartigem VerhaltenNutze die Debugger-Verbindung, um zu verfolgen, wie sich eine Sample während der Ausführung verhält.
- 3Erkennung von Binär-SchwachstellenSteuere einen AI-Client an, um Sicherheitslücken innerhalb einer Binärdatei mithilfe der Debugger-Funktionen zu finden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarlyshark/lyscript is public and reachablegithub.com/lyshark/lyscript ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-02github.com/lyshark/lyscript ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenLYSCRIPT Dynamic Debugging and Analysis Component
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.
Quick Installation
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",
"User-Agent": "Python-Robust-HTTP-Client/1.0"
}
[DEBUG] Request body:
{
"class": "Debugger",
"interface": "GetRegister",
"params": [
"EIP"
]
}
[DEBUG] Received response: Status=200 (OK), Body:
{
"status": "success",
"result": {
"message": "Register value retrieved successfully",
"register_name": "EIP",
"register_index": 30,
"value_decimal": 2008776905,
"value_hex": "0x77BB80C9",
"platform": "x86"
},
"timestamp": 12603843
}
[DEBUG] HTTP connection closed
>>>
>>> eip
{
'message': 'Register value retrieved successfully',
'register_name': 'EIP',
'register_index': 30,
'value_decimal': 2008776905,
'value_hex': '0x77BB80C9',
'platform': 'x86'
}
Finally, a dictionary result containing register names, values (decimal/hexadecimal), and other information will be returned. Debug logs can track interaction details.
LyScript MCP Fragen
Mit welchem Debugger arbeitet LyScript zusammen?
Es ist ein Plugin für den x32/x64dbg Debugger unter Windows, mit passenden 32-Bit und 64-Bit Plugin-Builds.
Wie installiere ich das LyScript Python-Package?
Installiere das x32dbg Package auf 32-Bit-Systemen oder das x64dbg Package auf 64-Bit-Systemen via pip.
Welche Protokolle können das LyScript Plugin aufrufen?
Es stellt eine universelle Schnittstelle bereit, die über POSTMAN, HTTP und MCP Protokolle aufrufbar ist.
Kann LyScript CPU-Registerwerte auslesen?
Ja, du kannst über die Debugger-Schnittstelle ein Register wie EIP abfragen und dezimale sowie hexadezimale Werte zurückerhalten.