LyScript MCP server
2026년 10월 2일 커밋AI 클라이언트가 x32/x64dbg 디버거를 제어하여 리버스 엔지니어링 과정에서 레지스터, 메모리, 모듈 및 디스어셈블리를 검사할 수 있게 합니다.
다른 이름 lyshark/LyScript
- 스타
- 82
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 2일
- 라이선스
- GPL-3.0
LyScript MCP란?
LyScript은(는) MCP server입니다. AI 클라이언트가 x32/x64dbg 디버거를 제어하여 리버스 엔지니어링 과정에서 레지스터, 메모리, 모듈 및 디스어셈블리를 검사할 수 있게 합니다.
프로젝트 README에서 생성된 요약
LyScript MCP server 정보
보안 연구원과 악성코드 분석가는 LyScript를 사용하여 AI 클라이언트를 통해 x32/x64dbg 디버거를 직접 제어할 수 있습니다. MCP 프로토콜을 통해 디버거와 통합함으로써, 이 서버는 AI가 레지스터 검사, 메모리 분석, 모듈 조사 및 디스어셈블리 보기와 같은 저수준 작업을 수행할 수 있도록 지원합니다. 이러한 구성은 대규모 언어 모델과 활성 디버깅 세션을 연결하여 자동화된 리버스 엔지니어링과 지능적인 브레이크포인트 분석을 가능하게 합니다.
이 도구를 사용하려면 LyScript 플러그인 파일을 Windows에 설치된 x32dbg 또는 x64dbg의 plugins 디렉토리에 넣어야 합니다. 환경에 따라 시스템 비트수에 맞춰 pip를 통해 x32dbg 또는 x64dbg Python 패키지를 설치해야 합니다. MCP 서비스가 실행되면 AI 클라이언트는 일반적으로 구성 객체를 사용하여 연결을 관리하며, 로컬 서비스 주소와 포트를 통해 디버거와 통신합니다.
활용 사례
- 1자동 레지스터 검사AI에게 EIP와 같은 특정 레지스터 값을 요청하여 현재 실행 상태를 파악합니다.
- 2악성 동작 추적디버거 연결을 사용하여 샘플이 실행되는 동안의 동작을 추적합니다.
- 3바이너리 취약점 탐지디버거 기능을 사용하여 AI 클라이언트가 바이너리 내의 보안 결함을 찾도록 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능lyshark/lyscript is public and reachablegithub.com/lyshark/lyscript ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-02github.com/lyshark/lyscript ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기LYSCRIPT 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 질문
LyScript는 어떤 디버거와 함께 작동하나요?
Windows용 x32/x64dbg 디버거를 위한 플러그인이며, 이에 맞는 32비트 및 64비트 플러그인 빌드를 제공합니다.
LyScript Python 패키지는 어떻게 설치하나요?
32비트 시스템에서는 x32dbg 패키지를, 64비트 시스템에서는 x64dbg 패키지를 pip로 설치하십시오.
어떤 프로토콜로 LyScript 플러그인을 호출할 수 있나요?
POSTMAN, HTTP 및 MCP 프로토콜을 통해 호출 가능한 범용 인터페이스를 제공합니다.
LyScript로 CPU 레지스터 값을 읽을 수 있나요?
네, Debugger 인터페이스를 통해 EIP와 같은 레지스터를 쿼리하고 10진수 및 16진수 값을 받아올 수 있습니다.