LyScript MCP server
Commit 2 Okt 2026Memungkinkan AI client untuk mengontrol debugger x32/x64dbg guna memeriksa register, memory, modules, dan disassembly selama proses reverse engineering.
Juga dikenal sebagai lyshark/LyScript
- Stars
- 82
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 2 Okt 2026
- Lisensi
- GPL-3.0
Apa itu LyScript MCP?
LyScript adalah MCP server. Memungkinkan AI client untuk mengontrol debugger x32/x64dbg guna memeriksa register, memory, modules, dan disassembly selama proses reverse engineering.
Ringkasan dibuat dari README proyek
Tentang LyScript MCP server
Security researcher dan malware analyst dapat menggunakan LyScript untuk mengontrol debugger x32/x64dbg secara langsung melalui AI client. Dengan integrasi ke debugger via protokol MCP, server ini memungkinkan AI untuk melakukan tugas low-level seperti memeriksa register, menganalisis memory, memeriksa modules, dan melihat disassembly. Setup ini memungkinkan reverse engineering otomatis dan analisis breakpoint yang cerdas dengan menghubungkan large language models ke sesi debugging yang sedang aktif.
Untuk menggunakan tool ini, Anda harus meletakkan file plugin LyScript ke dalam direktori plugins pada instalasi x32dbg atau x64dbg Anda di Windows. Lingkungan ini memerlukan instalasi package Python x32dbg atau x64dbg via pip, tergantung pada bitness sistem Anda. Setelah layanan MCP berjalan, AI client akan berkomunikasi dengan debugger melalui alamat service lokal dan port, biasanya menggunakan object configuration untuk mengelola koneksi tersebut.
Apa yang bisa Anda lakukan dengannya
- 1Automated register inspectionMinta AI untuk mengambil nilai register spesifik seperti EIP guna memahami status eksekusi saat ini.
- 2Malicious behavior tracingGunakan koneksi debugger untuk melacak bagaimana sebuah sample berperilaku selama eksekusi.
- 3Binary vulnerability detectionInstruksikan AI client untuk menemukan celah keamanan di dalam sebuah binary menggunakan kapabilitas debugger.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaulyshark/lyscript is public and reachablegithub.com/lyshark/lyscript ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-02github.com/lyshark/lyscript ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang LyScript MCP
Debugger apa yang didukung oleh LyScript?
LyScript adalah plugin untuk debugger x32/x64dbg di Windows, tersedia dalam build plugin 32-bit dan 64-bit yang sesuai.
Bagaimana cara menginstal package Python LyScript?
Instal package x32dbg pada sistem 32-bit atau x64dbg pada sistem 64-bit menggunakan pip.
Protokol apa saja yang bisa memanggil plugin LyScript?
LyScript menyediakan interface universal yang dapat dipanggil melalui protokol POSTMAN, HTTP, dan MCP.
Apakah LyScript bisa membaca nilai CPU register?
Ya, Anda dapat melakukan query pada register seperti EIP melalui interface Debugger dan mendapatkan nilai dalam format desimal maupun hex.