
Headless-сервер MCP для IDA Pro для анализа бинарного кода с помощью ИИ, на базе idalib
Headless IDA CLI и набор инструментов для анализа бинарных файлов на macOS и
Linux, ориентированный в первую очередь на навыки (skill-first). ida-cli автоматически выбирает серверный бэкенд, автоматически запускает локальный сервер
при необходимости и предоставляет одну и ту же поверхность в виде плоского CLI, stdio MCP
транспорта и Streamable HTTP MCP транспорта.
ida-cli (клиент + сервис в одном исполняемом файле)ida-cli (skill/SKILL.md) для агентских окруженийБазовый слой сервиса worker / router запускается и останавливается
CLI автоматически. Вам нужно запускать serve / serve-http явно
только тогда, когда вы действительно хотите долгоживущий, внешне адресуемый сервис.
Требования к среде выполнения: IDA 9.4/9.5 и Python >=3.11. Все операции с базой данных используют выделенное закреплённое окружение Nexus 0.13.4 / Domain 0.5.1. Отсутствующие зависимости или несовпадающие патчи приводят к явной ошибке. Сборки на Rust не требуют IDA SDK.
На поддерживаемых средах выполнения IDA 9.x ida-cli может:
.i64read_* и convert_numberrun_scriptВсе инструменты используют Nexus с явными ошибками возможностей. См. docs/TOOLS.md для сгенерированного списка инструментов.
Точка входа по умолчанию — навык ida-cli, а не ручная установка 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
После установки навык поставляется с собственным 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
Если ida-cli отсутствует, обёртка устанавливает его через установщик репозитория перед перенаправлением команды.
Используйте это, только если вам нужен автономный CLI без обращения к навыку.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Полезные варианты:
# 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
Примечания:
~/.local/bin/ida-cli.--add-path добавляет этот каталог bin в ваш rc-файл оболочки..app в /Applications или ~/Applications, а также выводятся выбранный и другие кандидаты. 9.10 новее, чем 9.9; завершающие нулевые компоненты считаются равными, а при равенстве порядок разрешается по каноническому пути. Явно заданный IDADIR имеет приоритет. Несовместимый выбранный wheel/runtime приводит к явной ошибке. Если кандидат не найден, установка завершается с инструкциями по заданию IDADIR.IDADIR переопределяет его; принимаются пути .app, Contents и runtime. См. сравнение версий и проверки 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 ориентирован в первую очередь на клиента. Любая клиентская подкоманда автоматически запускает локальный
Streamable-HTTP сервер, привязанный к случайному порту, и записывает
/tmp/ida-cli.socket для обнаружения:
./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"}}'
Чтобы увидеть, какие базы данных демон демонстрирует в данный момент открытыми и какие клиенты их удерживают, выполните list-idbs (инструмент MCP: list_idbs). Запускайте его перед пересборкой или заменой .i64, например с помощью idat: база данных, которая всё ещё в списке, удерживается открытой демоном, и idat завершается с ошибкой для базы данных, открытой в другом месте. Ответ имеет вид {"count": N, "idbs": [...]}; каждая запись содержит db_handle, входной путь и путь .i64, непрозрачный идентификатор клиента, открывшего её, время открытия, рабочий процесс, признак того, является ли она активной базой данных, и клиентов, которые всё ещё удерживают ссылки. Токены закрытия никогда не возвращаются.
./target/debug/ida-cli list-idbs --json
Чтобы получить адрес, стоящий за каждой строкой псевдокода, добавьте --line-addresses к
decompile (MCP и RPC: line_addresses: true в decompile_function). Ответ
приобретает вид {"code": ..., "lines": [...]}: code — обычный текст, а
каждый элемент lines — это {"line", "text", "addresses"}. line считается с 1,
text — это соответствующая строка code, а addresses — адреса IDA (шестнадцатеричные
строки, по возрастанию, без дубликатов) элементов ctree, к которым Hex-Rays привязал
строку. Строка может соответствовать нескольким несмежным адресам, и список не
включает каждую инструкцию оператора. У сигнатуры и локальных объявлений их нет; {, }, else и пустые строки могут нести адрес блока или
if, которым они принадлежат (точка входа функции для самых внешних фигурных скобок). Подсказка переименования sub_
в этом режиме не добавляется. Hex-Rays может выводить очень большую функцию
по-разному от вызова к вызову, поэтому используйте code и lines только из одного и того же
ответа. Nexus поддерживает этот режим. Через сокет CLI большой
ответ сохраняется в кэше ответов, как и любой другой (IDA_MCP_MAX_INLINE_BYTES).
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
Команды, первым аргументом которых является подкоманда сервиса (serve,
serve-http, serve-worker, probe-runtime), вместо этого переходят в режим сервиса: