Serveur MCP LyScript
Commit 2 oct. 2026Permet à un client IA de contrôler le débogueur x32/x64dbg pour inspecter les registres, la mémoire, les modules et le désassemblage lors de l'ingénierie inverse.
Aussi connu sous lyshark/LyScript
- Étoiles
- 82
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 2 oct. 2026
- Licence
- GPL-3.0
Qu'est-ce que LyScript MCP ?
LyScript est un serveur MCP. Permet à un client IA de contrôler le débogueur x32/x64dbg pour inspecter les registres, la mémoire, les modules et le désassemblage lors de l'ingénierie inverse.
Résumé généré à partir du README du projet
À propos du MCP server LyScript
Les chercheurs en sécurité et les analystes de malwares peuvent utiliser LyScript pour contrôler les débogueurs x32/x64dbg directement via un client IA. En s'intégrant au débogueur via le protocole MCP, le serveur permet à une IA d'effectuer des tâches de bas niveau comme l'inspection des registres, l'analyse de la mémoire, l'examen des modules et la visualisation du désassemblage. Cette configuration permet l'automatisation de l'ingénierie inverse et l'analyse intelligente des points d'arrêt en faisant le pont entre les grands modèles de langage et des sessions de débogage actives.
Pour utiliser cet outil, vous devez placer le fichier du plugin LyScript dans le répertoire plugins de votre installation x32dbg ou x64dbg sur Windows. L'environnement nécessite l'installation du package Python x32dbg ou x64dbg via pip, selon l'architecture de votre système. Une fois le service MCP en cours d'exécution, le client IA communique avec le débogueur via une adresse de service locale et un port, en utilisant généralement un objet de configuration pour gérer la connexion.
Ce que vous pouvez faire avec
- 1Inspection automatisée des registresDemandez à l'IA de récupérer des valeurs de registres spécifiques comme EIP pour comprendre l'état d'exécution actuel.
- 2Traçage de comportements malveillantsUtilisez la connexion au débogueur pour suivre le comportement d'un échantillon pendant son exécution.
- 3Détection de vulnérabilités binairesDirigez un client IA pour identifier des failles de sécurité au sein d'un binaire en utilisant les capacités du débogueur.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblelyshark/lyscript is public and reachablegithub.com/lyshark/lyscript ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-02github.com/lyshark/lyscript ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur LyScript MCP
Avec quel débogueur LyScript fonctionne-t-il ?
Il s'agit d'un plugin pour le débogueur x32/x64dbg sur Windows, avec des builds de plugin correspondants en 32 bits et 64 bits.
Comment installer le package Python LyScript ?
Installez le package x32dbg sur les systèmes 32 bits ou x64dbg sur les systèmes 64 bits avec pip.
Quels protocoles peuvent appeler le plugin LyScript ?
Il expose une interface universelle appelable via les protocoles POSTMAN, HTTP et MCP.
LyScript peut-il lire les valeurs des registres CPU ?
Oui, vous pouvez interroger un registre tel que EIP via l'interface du débogueur et obtenir les valeurs en décimal et en hexadécimal.