Skip to content

hgxszhj/https-github.com-zhaoxuya520-reverse-skill / skills/ida-reverse

ida-reverse

Verified

IDA Pro 逆向分析辅助技能。当用户提到逆向、反编译、分析二进制/PE/ELF/APK/DLL/SO、破解、找密码、漏洞分析、病毒分析、firmware 固件分析,或需要分析 exe/dll/so/elf/macho/sys 等文件时,务必使用此技能。 Ensure to use this skill when the user wants to analyze any binary file, regardless of whether they explicitly mention "IDA" or "reverse engineering". This includes requests like "看看这个exe", "分析这个dll", "帮我破解", "找一下密码", "这个软件怎么注册", etc. Use the bundled scripts (scripts/start.ps1, scripts/open.ps1) for deterministic server management and file opening — do NOT write ad-hoc PowerShell commands for these operations.

FileKindSize
LOCAL-SETUP.mdmarkdown3.3 KB
SKILL.mdskill md19.6 KB
references/ida-mcp-cheatsheet.mdmarkdown11.0 KB
scripts/IdaOpenHelpers.ps1script3.7 KB
scripts/install-autostart.ps1script2.4 KB
scripts/open.ps1script12.9 KB
scripts/recover.ps1script458 B
scripts/run-supervisor.pyscript4.2 KB
scripts/start-gui.ps1script3.8 KB
scripts/start.ps1script18.4 KB
scripts/watchdog.ps1script4.6 KB

scripts/run-supervisor.py

View on GitHub
"""Hidden idalib supervisor launcher with file logging.

Started via pythonw so no console window appears. stdout/stderr and the
logging module both go to %LOCALAPPDATA%\\reverse-skill\\ida-mcp\\supervisor.log.
"""

from __future__ import annotations

import os
import sys
from datetime import datetime
from pathlib import Path


def _log_path() -> Path:
    root = Path(os.environ.get("LOCALAPPDATA") or ".") / "reverse-skill" / "ida-mcp"
    root.mkdir(parents=True, exist_ok=True)
    return root / "supervisor.log"


def _rotate(path: Path, max_bytes: int = 5 * 1024 * 1024) -> None:
    if path.exists() and path.stat().st_size > max_bytes:
        bak = path.with_name(path.name + ".1")
        if bak.exists():
            bak.unlink()
        path.replace(bak)


def main() -> None:
    log_path = _log_path()
    _rotate(log_path)
    log_fp = open(log_path, "a", encoding="utf-8", buffering=1, errors="replace")
    sys.stdout = log_fp
    sys.stderr = log_fp
    print(
        f"==== start {datetime.now():%Y-%m-%d %H:%M:%S} pid={os.getpid()} ====",
        flush=True,
    )

    try:
        _patch_streamable_http()
    except Exception as exc:
        print(f"WARN: streamable-http patch skipped: {exc}", flush=True)

    from ida_pro_mcp.idalib_supervisor import main as supervisor_main

    supervisor_main()


def _patch_streamable_http() -> None:
    """HTTP MCP clients use Streamable HTTP on /mcp.

    Stock idalib_supervisor serves with background=False → HTTPServer
    (one request at a time). A GET /sse or GET /mcp that stays open
    then makes tools/list hang, and the client marks the server error.
    GET /mcp also returned 405, which breaks live tool discovery.
    """
    import select
    import socket
    import sys
    import time
    import uuid
    from urllib.parse import urlparse

    # Vendored zeromcp lives under site-packages/ida_pro_mcp/ida_mcp.
    # Do not import ida_pro_mcp.ida_mcp (that pulls idaapi).
    import ida_pro_mcp.idalib_supervisor as _sup

    zm_dir = Path(_sup.__file__).resolve().parent / "ida_mcp"
    sys.path.insert(0, str(zm_dir))
    try:
        import zeromcp.mcp as zm  # type: ignore
    finally:
        sys.path.remove(str(zm_dir))

    zm.HTTPServer = zm.ThreadingHTTPServer

    orig_get = zm.McpHttpRequestHandler.do_GET

    def do_get(self):
        if not self._check_api_request():
            return
        if urlparse(self.path).path != "/mcp":
            return orig_get(self)

        session_id = self.headers.get("Mcp-Session-Id") or str(uuid.uuid4())
        self.mcp_server.register_http_session(session_id)
        conn = zm._McpSseConnection(self.wfile)
        self.mcp_server._sse_connections[conn.session_id] = conn
        try:
            self.send_response(200)
            self.send_header("Content-Type", "text/event-stream")
            self.send_header("Cache-Control", "no-cache")
            self.send_header("Connection", "keep-alive")
            self.send_header("Mcp-Session-Id", session_id)
            self.send_cors_headers()
            self.end_headers()
            sock = self.connection
            if sock and hasattr(sock, "settimeout"):
                try:
                    sock.settimeout(1.0)
                except OSError:
                    pass
            last_ping = time.time()
            while conn.alive and self.mcp_server._running:
                now = time.time()
                if sock:
                    try:
                        readable, _, _ = select.select([sock], [], [], 1.0)
                        if readable and sock.recv(1, socket.MSG_PEEK) == b"":
                            break
                    except (OSError, socket.error, ConnectionResetError, BrokenPipeError):
                        break
                else:
                    time.sleep(1.0)
                if now - last_ping >= 30:
                    try:
                        conn.send_event("ping", "")
                    except (OSError, BrokenPipeError):
                        break
                    last_ping = now
        finally:
            conn.alive = False
            self.mcp_server._sse_connections.pop(conn.session_id, None)

    zm.McpHttpRequestHandler.do_GET = do_get


if __name__ == "__main__":
    main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall