MCP server de LyScript
Commit 2 oct 2026Permite que un cliente de IA controle el depurador x32/x64dbg para inspeccionar registros, memoria, módulos y el disassembly durante procesos de ingeniería inversa.
También conocido como lyshark/LyScript
- Stars
- 82
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 2 oct 2026
- Licencia
- GPL-3.0
¿Qué es LyScript MCP?
LyScript es un MCP server. Permite que un cliente de IA controle el depurador x32/x64dbg para inspeccionar registros, memoria, módulos y el disassembly durante procesos de ingeniería inversa.
Resumen generado a partir del README del proyecto
Acerca del MCP server de LyScript
Los investigadores de seguridad y analistas de malware pueden usar LyScript para controlar los depuradores x32/x64dbg directamente a través de un cliente de IA. Al integrarse con el depurador mediante el protocolo MCP, el servidor permite que una IA realice tareas de bajo nivel como inspeccionar registros, analizar la memoria, examinar módulos y visualizar el disassembly. Esta configuración permite la ingeniería inversa automatizada y el análisis inteligente de breakpoints al conectar modelos de lenguaje extensos con sesiones de depuración activas.
Para usar esta herramienta, debes colocar el archivo del plugin LyScript en el directorio plugins de tu instalación de x32dbg o x64dbg en Windows. El entorno requiere instalar el paquete de Python x32dbg o x64dbg vía pip, dependiendo de la arquitectura de tu sistema. Una vez que el servicio MCP esté en ejecución, el cliente de IA se comunicará con el depurador a través de una dirección de servicio local y un puerto, utilizando normalmente un objeto de configuración para gestionar la conexión.
Qué puedes hacer con él
- 1Inspección automatizada de registrosPide a la IA que recupere valores de registros específicos como EIP para entender el estado de ejecución actual.
- 2Rastreo de comportamiento maliciosoUtiliza la conexión con el depurador para rastrear cómo se comporta una muestra durante la ejecución.
- 3Detección de vulnerabilidades en binariosDirige a un cliente de IA para encontrar fallos de seguridad dentro de un binario utilizando las capacidades del depurador.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblelyshark/lyscript is public and reachablegithub.com/lyshark/lyscript ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-02github.com/lyshark/lyscript ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubLYSCRIPT 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.
Preguntas sobre LyScript MCP
¿Con qué depurador funciona LyScript?
Es un plugin para el depurador x32/x64dbg en Windows, con versiones de plugin correspondientes para 32 y 64 bits.
¿Cómo instalo el paquete de Python LyScript?
Instala el paquete x32dbg en sistemas de 32 bits o x64dbg en sistemas de 64 bits usando pip.
¿Qué protocolos pueden llamar al plugin LyScript?
Expone una interfaz universal que se puede llamar a través de los protocolos POSTMAN, HTTP y MCP.
¿Puede LyScript leer valores de registros de la CPU?
Sí, puedes consultar un registro como EIP a través de la interfaz del depurador y obtener valores tanto en decimal como en hexadecimal.