
Servidor MCP headless do IDA Pro para análise binária assistida por IA, alimentado por idalib
CLI IDA headless e toolkit com foco em skills para análise de binários no macOS e
Linux. O ida-cli seleciona automaticamente um backend de runtime, inicia automaticamente um servidor local
quando necessário, e expõe a mesma superfície como uma CLI plana, um transporte MCP
stdio, e um transporte MCP Streamable HTTP.
ida-cli (cliente + serviço em um único executável)ida-cli (skill/SKILL.md) para ambientes de agenteA camada de serviço subjacente de worker / router é iniciada e encerrada pela
CLI automaticamente. Você só precisa executar serve / serve-http explicitamente
quando realmente deseja um serviço de longa duração e endereçável externamente.
Requisitos de runtime: IDA 9.4/9.5 e Python >=3.11. Todas as operações de banco de dados usam o ambiente dedicado e fixado Nexus 0.13.4 / Domain 0.5.1. Dependências ausentes ou patches incompatíveis falham explicitamente. Builds em Rust não precisam do IDA SDK.
Em runtimes IDA 9.x suportados, o ida-cli pode:
.i64 em cacheread_* e convert_numberrun_scriptTodas as ferramentas usam Nexus com erros explícitos de capacidade. Consulte docs/TOOLS.md para a lista de ferramentas gerada.
O ponto de entrada padrão é a skill ida-cli, não uma instalação manual da CLI.
# list the skill exposed by this repository
npx -y skills add https://github.com/cpkt9762/ida-cli --list
# install the ida-cli skill for Codex
npx -y skills add https://github.com/cpkt9762/ida-cli --skill ida-cli --agent codex --yes --global
Após a instalação, a skill inclui seu próprio wrapper de bootstrap:
~/.agents/skills/ida-cli/scripts/ida-cli.sh --help
~/.agents/skills/ida-cli/scripts/ida-cli.sh probe-runtime
~/.agents/skills/ida-cli/scripts/ida-cli.sh --path /path/to/binary list-functions --limit 20
Se o ida-cli estiver ausente, o wrapper o instala através do instalador do repositório antes de encaminhar o comando.
Use isto apenas se você quiser a CLI autônoma sem passar pela skill.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Variantes úteis:
# install a specific release
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --tag v0.9.3 --add-path
# build directly from a branch or ref
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --ref master --build-from-source --add-path
Notas:
~/.local/bin/ida-cli por padrão.--add-path acrescenta esse diretório bin ao seu arquivo rc do shell..app em /Applications ou ~/Applications e exibe a selecionada e as demais candidatas. 9.10 é mais recente que 9.9; componentes finais iguais a zero são equivalentes, com a ordem canônica de caminho desempatando. Um IDADIR explícito tem prioridade. Um wheel/runtime selecionado incompatível falha explicitamente. Se nenhuma candidata for encontrada, a instalação falha com instruções para definir IDADIR.IDADIR explícito o substitui; caminhos .app, Contents e de runtime são aceitos. Consulte comparação de versões e verificações de runtime.git clone https://github.com/cpkt9762/ida-cli.git
cd ida-cli
export IDADIR="/Applications/IDA Professional 9.5.app/Contents/MacOS" # or a Linux install
cargo build --bin ida-cli
./target/debug/ida-cli --help
ida-cli é client-first. Qualquer subcomando de cliente inicia automaticamente um servidor local
Streamable-HTTP vinculado a uma porta aleatória e grava
/tmp/ida-cli.socket para descoberta:
./target/debug/ida-cli --path /path/to/sample.bin list-functions --limit 20
./target/debug/ida-cli --path /path/to/sample.bin decompile --addr 0x140001000
./target/debug/ida-cli --path /path/to/sample.bin raw '{"method":"get_xrefs_to","params":{"address":"0x140001000"}}'
Para ver quais bancos de dados o daemon mantém abertos no momento, e quais clientes os mantêm, execute list-idbs (ferramenta MCP: list_idbs). Execute-o antes de reconstruir ou substituir um .i64, por exemplo com idat: um banco de dados que ainda está listado é mantido aberto pelo daemon, e idat falha em um banco de dados que está aberto em outro lugar. A resposta é {"count": N, "idbs": [...]}; cada entrada contém o db_handle, o caminho de entrada e o caminho .i64, um id opaco do cliente que o abriu, quando foi aberto, o processo worker, se é o banco de dados ativo, e os clientes que ainda mantêm referências. Tokens de fechamento nunca são retornados.
./target/debug/ida-cli list-idbs --json
Para obter o endereço por trás de cada linha de pseudocódigo, adicione --line-addresses a
decompile (MCP e RPC: line_addresses: true em decompile_function). A
resposta passa a ser {"code": ..., "lines": [...]}: code é o texto habitual e
cada entrada de lines é {"line", "text", "addresses"}. line conta a partir de 1,
text é aquela linha de code, e addresses são os endereços IDA (strings
hexadecimais, ascendentes, sem duplicados) dos itens da ctree nos quais o Hex-Rays ancorou a
linha. Uma linha pode corresponder a vários endereços não contíguos, e a lista não é
todas as instruções da instrução. A assinatura e as declarações locais não têm
nenhum; {, }, else e linhas em branco podem conter o endereço do bloco ou
if que as possui (a entrada da função para as chaves mais externas). A dica de
renomeação sub_ não é adicionada neste modo. O Hex-Rays pode imprimir uma função muito grande
de forma diferente de uma chamada para outra, portanto use code e lines da mesma
resposta apenas. O Nexus suporta este modo. Através do socket CLI, uma resposta
grande é armazenada no cache de respostas como qualquer outra (IDA_MCP_MAX_INLINE_BYTES).
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
Comandos cujo primeiro argumento é um subcomando de serviço (serve,
serve-http, serve-worker, probe-runtime) entram no modo de serviço:
./target/debug/ida-cli serve # stdio MCP transport
./target/debug/ida-cli serve-http --bind 127.0.0.1:8765
./target/debug/ida-cli probe-runtime
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.