hgxszhj/https-github.com-zhaoxuya520-reverse-skill / skills/ida-reverse
ida-reverse
VerifiedIDA 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.
| File | Kind | Size |
|---|---|---|
| LOCAL-SETUP.md | markdown | 3.3 KB |
| SKILL.md | skill md | 19.6 KB |
| references/ida-mcp-cheatsheet.md | markdown | 11.0 KB |
| scripts/IdaOpenHelpers.ps1 | script | 3.7 KB |
| scripts/install-autostart.ps1 | script | 2.4 KB |
| scripts/open.ps1 | script | 12.9 KB |
| scripts/recover.ps1 | script | 458 B |
| scripts/run-supervisor.py | script | 4.2 KB |
| scripts/start-gui.ps1 | script | 3.8 KB |
| scripts/start.ps1 | script | 18.4 KB |
| scripts/watchdog.ps1 | script | 4.6 KB |
scripts/watchdog.ps1
View on GitHub<#
.SYNOPSIS
Ensure IDA Pro MCP HTTP is healthy; start or replace it when needed.
.DESCRIPTION
One-shot health check used by the scheduled task. Safe to run every minute:
a live server is reused; GUI / open.ps1 in-flight / last-healthy younger
than 3 minutes is reused; tools/list unhealthy for 3 minutes is replaced
via start.ps1 -Force; a dead listener is started via start.ps1.
Usage:
powershell -File watchdog.ps1
#>
param(
[int]$Port = 13337
)
$ErrorActionPreference = 'Stop'
. (Join-Path $PSScriptRoot 'IdaOpenHelpers.ps1')
$logDir = Join-Path $env:LOCALAPPDATA 'reverse-skill\ida-mcp'
if (-not (Test-Path -LiteralPath $logDir)) {
New-Item -ItemType Directory -Path $logDir -Force | Out-Null
}
$logFile = Join-Path $logDir 'watchdog.log'
if ((Test-Path -LiteralPath $logFile) -and ((Get-Item -LiteralPath $logFile).Length -gt 2MB)) {
$bak = "$logFile.1"
if (Test-Path -LiteralPath $bak) { Remove-Item -LiteralPath $bak -Force }
Move-Item -LiteralPath $logFile -Destination $bak -Force
}
function Write-WatchLog {
param([string]$Message)
$line = '{0} {1}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $Message
Add-Content -LiteralPath $logFile -Value $line -Encoding UTF8
Write-Output $Message
}
function Get-IdaMcpPortOwners {
param([int]$Port)
try {
return @(
Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue |
Select-Object -ExpandProperty OwningProcess -Unique |
Where-Object { $_ -and $_ -gt 0 }
)
} catch {
return @()
}
}
function Probe-IdaMcp {
param([int]$Port)
$owners = @(Get-IdaMcpPortOwners -Port $Port)
try {
$r = Invoke-RestMethod "http://127.0.0.1:$Port/mcp" -Method Post `
-Body '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' `
-ContentType 'application/json' -TimeoutSec 3 -ErrorAction Stop
$tools = @($r.result.tools)
$count = $tools.Count
$names = @($tools | ForEach-Object { $_.name })
if ($count -gt 0 -and ($names -contains 'py_eval')) {
return @{ Status = 'healthy'; Count = $count }
}
if ($count -gt 0) {
return @{ Status = 'stale'; Count = $count }
}
} catch {}
# Listen + RPC timeout: GUI or in-flight idb_open = busy.
# Deadlock is consecutive tools/list failures >180s (last-healthy), not process age.
if ($owners.Count -gt 0) {
return @{ Status = 'busy'; Count = 0; Owners = $owners }
}
return @{ Status = 'down'; Count = 0; Owners = @() }
}
function Get-IdaMcpProcessInfo {
param([int]$ProcessId)
return Get-CimInstance Win32_Process -Filter "ProcessId=$ProcessId" -ErrorAction SilentlyContinue
}
function Test-IdaGuiProcess {
param([int]$ProcessId)
$proc = Get-IdaMcpProcessInfo -ProcessId $ProcessId
if (-not $proc) { return $false }
return [string]$proc.Name -match '(?i)^(ida|ida64|idaq|idaq64)\.exe$'
}
function Test-DeadlockedSupervisor {
param(
[int[]]$Owners,
[int]$Port
)
$gui = @($Owners | Where-Object { Test-IdaGuiProcess -ProcessId $_ })
if ($gui.Count -gt 0) { return $false }
return Test-IdaMcpKeepaliveDeadlockFromFacts `
-GuiOwnsPort $false `
-OpeningInFlight (Test-IdaMcpOpeningInFlight -Port $Port) `
-LastHealthy (Read-IdaMcpLastHealthy -Port $Port) `
-Now (Get-Date)
}
$probe = Probe-IdaMcp -Port $Port
if ($probe.Status -eq 'healthy') {
Write-IdaMcpLastHealthy -Port $Port
Write-WatchLog "OK:$($probe.Count)`:reuse"
exit 0
}
if ($probe.Status -eq 'busy') {
$owners = @($probe.Owners)
if (Test-DeadlockedSupervisor -Owners $owners -Port $Port) {
Write-WatchLog ("INFO:deadlock pids={0}, calling start.ps1 -Force" -f ($owners -join ','))
$startScript = Join-Path $PSScriptRoot 'start.ps1'
$startOutput = & $startScript -Port $Port -Force
foreach ($line in @($startOutput)) {
Write-WatchLog "START:$line"
}
$last = (@($startOutput) | Where-Object { $_ -match '^(OK|ERR|WARN):' } | Select-Object -Last 1)
if ($last -match '^(OK:|WARN:gui_busy|WARN:busy)') {
exit 0
}
exit 1
}
Write-WatchLog 'OK:busy:reuse'
exit 0
}
Write-WatchLog ("INFO:{0}, calling start.ps1" -f $probe.Status)
$startScript = Join-Path $PSScriptRoot 'start.ps1'
$startOutput = & $startScript -Port $Port
foreach ($line in @($startOutput)) {
Write-WatchLog "START:$line"
}
$last = (@($startOutput) | Where-Object { $_ -match '^(OK|ERR|WARN):' } | Select-Object -Last 1)
if ($last -match '^(OK:|WARN:gui_busy|WARN:busy)') {
exit 0
}
exit 1
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 467k | Updated | Claude CodeCodex | Verified | Install |
| 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: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |