LyScript MCPサーバー
コミット 2026年10月2日AIクライアントからx32/x64dbgデバッガを制御し、リバースエンジニアリング中のレジスタ、メモリ、モジュール、および逆アセンブリの検査を可能にします。
別名 lyshark/LyScript
- スター
- 82
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月2日
- ライセンス
- GPL-3.0
LyScript MCPとは
LyScriptはMCPサーバーです。 AIクライアントからx32/x64dbgデバッガを制御し、リバースエンジニアリング中のレジスタ、メモリ、モジュール、および逆アセンブリの検査を可能にします。.
プロジェクトのREADMEから生成された概要
LyScript MCP server について
セキュリティ研究者やマルウェアアナリストは、LyScriptを使用することで、AIクライアントからx32/x64dbgデバッガを直接制御できます。MCPプロトコルを介してデバッガと統合することで、このサーバーはAIによるレジスタの検査、メモリの解析、モジュールの調査、逆アセンブリの表示といった低レイヤーのタスクの実行を可能にします。この構成により、大規模言語モデルとアクティブなデバッグセッションを橋渡しし、自動化されたリバースエンジニアリングやインテリジェントなブレークポイント解析が実現します。
このツールを使用するには、Windows上のx32dbgまたはx64dbgのインストールディレクトリ内にあるpluginsディレクトリに、LyScriptプラグインファイルを配置する必要があります。環境としては、システムのビット数に応じて、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進数の値を取得できます。